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ABSTRACT 


This  thesis  describes  the  design  and  implementation  of 
a high  level#  general  puroose#  interactive  graphics 
subroutine  library  for  the  Vector  General  Interactive  Graph- 
ics Display  System.  The  lower  interface  levels  of  the  sys- 
tem and  its  effects  on  the  development  of  this  high  level 
interface  are  discussed.  The  problems  and  various 
approaches  associated  with  the  development  of  a general  pur- 
pose# high  level  applications  subroutine  library  that  is 
user  oriented  is  outlined.  The  basic  desian  ooals#  solu- 
tions and  recommendations  for  further  expansion  of  the  sys- 
tem are  presented.  This  araphics  subroutine  library  is 
implemented  within  the  conventions  of  the  C-Programmi ng 
language  and  the  UNIX  operating  system  as  implemented  on  the 
PDP-11/50  in  the  Naval  Postgraduate  School  Computer  Labora- 
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INTPODUC  T ION 


This  thesis  discusses  the  desiqn  and  implementation  of 
a high  level » general  purpose  graphics  subroutine  library 
for  an  interactive  graphics  disolav  system.  The  subroutine 
library  -was  desianea  to  suooort  the  Vector  General  Interac- 
tive Display  System  (Vector  General)  (11,  as  installed  at 
the  Naval  Postgraduate  School  Computer  Laboratory. 

Tne  Vector  General  represents  a highly  sophisticated 
graphics  display  terminal  with  hardware  implemented  three 
dimensional  rotation,  ' rarsl at  ion  and  sea  I i rq.  An 
alohan um eric  keyboard,  lighted  function  switches,  control 
dials  and  light  pen  provide  the  interactive  tools  of  the 
system.  The  Vector  General  i s interfaced  with  a P C P - 1 1 / 5 0 
computer  and  is  suonorted  by  the  UNIX  operating  system. 

The  actual  design  and  i mo  1 ement at i on  of  this  high 
level,  general  purpose  interface  is  di scusseo  as  well  as  the 
goals  and  problems  encountered  during  it's  development.  The 
oroblems  included  providing  a user  with  the  ability  to 
describe  and  name  picture  seaments,  designing  functions  that 
would  not  limit  the  capabilities  of  the  machine,  and  how  to 
effectively  utilize  the  existing  interface  levels.  The  main 
goal  was  the  development  and  implementation  of  a simple, 
easy  to  use,  general  purpose  graphics  subroutine  library. 
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A user's  manual  was  written,  describina  tne  implemented 


library  functions,  so  a user  can  easily  utilize  the  graphic 
caoaoilities  of  the  Vector  General  from  a proqram  written  in 
the  hiqh  level  lanquaqe,  C C ? 1 . This  is  included  as  Appen- 
dix A . 
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II.  DESCRIPTION  OF  THE  VECTOR  GENERAL 


T he  Vector  General  Graphics  Display  System  is  an 
interactive  graphic  cathode  rav  tube  (CRT)  display  that  is 
interfaced  with  a POP-11/50  computer.  The  display  interacts 
with  a user  by  disp'ayina  pictorial  datai  proqrammat i c 1 y 
descrioed  by  the  user,  on  the  surface  of  the  CRT.  The  sys- 
tem provides  both  hardware  features  and  external  control 
devices  that  can  be  utilized  by  a user  to  alter  and  manipu- 
late the  pictorial  data  being  displayed. 

A.  hardware  features 

The  cathode  ray  tube  (CRT)  is  the  most  widely  used 
graphics  display  device  and  the  one  capable  of  generating 
and  dynamically  changing  graphical  data.  The  Vector  General 
display  consists  of  a CRT  and  has  many  supporting  hardware 
features  (1,3).  The  hardware  features  provide,  in  addition 
to  a vector  generator,  a circle-arc  generator  and  a charac- 
ter generator.  The  system  also  has  hardware  implemented 
three  dimensional  rotation,  translation  and  scaling.  The 
features  are  controlled  and  coordinated  by  the  Vector  Gen- 
eral display  controller.  The  controller  is  also  responsible 
for  handlinq  communications  with  the  external  control  dev- 
ices. These  external  devices  include  an  alphanumeric  key- 
board, thirty-two  lighted  function  switches,  ten  control 
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FIGURE  1 

Vector  General  Disolay  Syster 
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EXISTING  INTEPFACF  LEVELS 


III. 


The  existing  interface  levels  for  t^e  Vector  General 
provide  an  efficient  interface  with  the  PDP-11/50  and  a user 
software  interface  Package  makes  the  detailed  operations  of 
the  system  transparent  to  the  user. 

A.  UNIX  AND  PDP-11/50  INTERFACE 

The  Vector  General  is  interfaced  with  a PDP-11/50  com- 
puter havinq  fe  4 K bytes  of  memory  and  uo  to  sixteen  million 
bytes  of  disk  storaat,  The  interface  was  designed  to  be 
used  in  the  mu t 1 i o r oq r amm i ng  environment  of  the  UNIX  time 
s^arinq  ooeratinq  system  [a]. 

This  interface  provides  the  Vector  General  display  pro- 
cessor with  access  to  a 32K  block  of  PDP-11/50  memory.  The 
Vector  General  display  data  is  maintained  within  this  block, 
and  is  continually  accessed  through  a Direct  Memory  Access 
(DMA)  channel  by  the  Vector  Genera)  processor  in  order  to 
refresh  the  display  screen.  This  approach  frees  the  PDP- 
lt/50  processor  for  other  tasks,  for  example  executing  user 
proarams.  A detailed  description  of  this  interface  design 
can  be  found  in  the  Design  Manual  for  the  Vector  General 


Perhaps  the  most"  important  aspect  of  this  interface  is 
the  resulting  support  of  the  Vector  General  by  the  UNIX 
operating  system.  This  added  dimension  provides  the  graph- 
ics user  with  ail  the  features  of  a general -purpose*  multi- 
user# interactive  operating  system  in  addition  to  rhe 
graphic  capabilities  provided  bv  the  Vector  General. 

The  UNIX  operating  system  is  designed  to  provide  a user 
with  a system  that  is  simple  and  easy  to  use  [A].  i t h i n 
this  framework  extremely  powerful  features  are  available  to 
the  user.  These  include:  a hierarchical  file  system,  a sys- 
tem command  language,  compatible  file-device  and  inter- 
process I/O,  over  100  subsystems  including  several  languages 
and  the  ability  to  initiate  asynchronous  processes.  The 
system's  primary  high  level  languages  are  C and  Fortran. 

These  features  of  the  UNIX  operating  system  provide  an 
efficient  and  flexible  environment  for  a graphics  user.  The 
user  has  the  facilities  to  maintain  and  manipulate  large 
graphical  data  files.  Communications  links  with  devices 
such  as  taoe  drives  and  disks  are  easily  established.  The 
command  language  provides  for  the  creation,  reading  and 
writing  of  files  and  for  transferring  them  between  devices. 
An  interactive  text  editor  is  available  for  program  crea- 
tion, as  is  an  interactive  debugger  for  program  debugging. 
These  are  only  a few  of  the  extra  facilities  that  become 
part  of  the  graphic  users  environment  due  to  this  interface 
with  UNIX  and  the  PDP-11/50. 
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Moving  the  Vector  General  from  a self  suoportinq  stand 


alone  qraohics  environment#  to  one  supported  by  a powerful 
operating  system#  greatly  extends  the  resources  available  to 
the  user.  This  extended  svstem  provides  an  environment  for 
the  development  of  a truely  general  purpose#  hiqh  level 
graphics  display  system. 

B.  LOWER  LEVEL  USE®  INTERFACE 


The  existinq  user  interface  software  package  defines 
high  level  constructs  which  the  interface  routines  convert 
to  Vector  General  commands.  These  constructs  define  a 
hierarchical  picture  structure  within  which  a user  can  iden- 
tify meaningful  picture  segments.  The  three  construct  lev- 
els defined  by  the  sof teware  interface  are:  picture#  object 
and  e 1 ement  16) . 

1.  Picture  Structure 


The  construct  level#  picture#  refers  to  all  the  data 
that  is  to  be  displayed  on  the  Vector  General  display 
screen.  An  element  refers  to  the  smallest  picture  entity 
that  can  be  independently  referenced  and  changed  without 
affecting  the  remainder  of  the  picture.  Each  element  is 
defined  bv  a series  of  Vector  General  display  instructions. 
An  object  represents  the  lowest  construct  that  can  be 
displayed  alone.  Each  object  consists  of  one  or  more  user 
defined  elements.  An  object  is  independently  rotatable# 
translatable  and  scalable  to  any  portion  of  the  display 
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screen.  The  oicture  defines  the  oicture  scale  and  screen 
coordinates  for  all  objects. 

• 

The  generation  and  contents  of  the  construct/  pic- 
ture and  object  are  the  responsibility  of  the  interface 
software.  A series  of  user  routines  are  provided  for  the 
programmer  to  establish  the  desired  object*  element  associa- 
tions. Additional  routines  are  available  to  dynamically 
modify  picture*  object  and  element  parameters. 

These  three  constructs  provide  a logical  base  for 
structuring  of  pictorial  data  by  a user.  It  does  not*  how- 
ever* produce  an  optimal  user  interface.  The  present  inter- 
face provides  no  assistance  in  the  creation  of  the  display 
instructions  that  describe  each  element.  The  user  is 
responsible  for  correctly  dimensionino  an  array  for  each 
element  and  for  filling  it  with  the  correct  Vector  General 
display  instructions.  These  instructions  reauire  the  user  to 
specify  coordinate  values  with  respect  to  the  screen  coordi- 
nate system,  and  to  specify  coordinate  registers  and  the 
desired  action(i.e.,  load*  draw  or  move).  This  process  of 
describing  elements  does  not  provide  a user  with  a clear, 
simple  and  unified  set  of  concepts  for  developing  graphic 
displays.  It  requires  the  user  to  concentrate  on  the  graph- 
ics device*  its  registers*  coordinate  system  and  capabili- 
ties and  not  on  the  picture  that  is  to  be  created.  The  pro- 
cess is  both  tedious  and  error-prone.  The  existing  interface 
does  not  provide  an  optimal  user  enviornment*  although  it 
does  offer  a base  for  a higher  level  user  interface. 
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2.  Display  List  Structure 


The  hierarchical  oicture  structure  orovided  by  the 
three  construct  levels  is  supported  by  the  i *p  1 eiren  t a t 1 on  of 
a segmented  display  list  (SI.  This  allows  for  the  dynamic 
modification  of  each  construct  level  which  is  a necessity 
for  an  interactive  graphics  system  (71.  A significant 
aspect  of  this  implementation  is  that  it  supports  the  con- 
cept of  shared  disolay  code.  This  is  analagous  to  a conven- 
tional subroutine  call  which  allows  sections  of  code  to  be 
used  repeatedly.  Thus,  a user  can  define  one  element  struc- 
ture and  by  associating  it  with  an  object  several  times, 
cause  the  element  to  appear  repeatedly  in  a picture. 


IV.  GENERAL  INTERFACE  DESIGN  CONCEPTS 


The  existing  user  interface  levels  supporting  the  Vec- 
tor General  and  the  environment  in  which  it  resides  has  been 
briefly  outlined.  The  present  system  does  not  orovioe  an 
adequate  interface,  but  does  provide  the  base  for  the 
further  development  of  the  system.  The  environment  created 
by  the  UNIX  operating  system  also  supports  the  concept  of  a 
high  level  graphics  interface  for  the  Vector  General 
display.  The  tools  for  constructing  a high  level  interface 
were  available,  the  decision  now  was  how  to  design  an  inter- 
face package  that  could  utilize  the  existing  environment  and 
provide  an  optimal  user  interface. 

A.  graphics  language  design 

In  designing  a hiah  level  interface  the  main  considera- 
tion is  the  development  of  a hiah  level  graphics  programming 
language.  The  need  for  such  a 1 anguaae  for  the  construction 
and  manipulation  of  graphical  data  cannot  be  overlooked. 
The  ease  with  which  a system  can  be  programmed  is  a major 
factor  in  determining  how  a system  will  be  utilized  18). 

A graphics  1 anquage  must  provide  a method  for  describing 
pictures  (PI.  The  language  must  have  facilities  for 
describing  not  only  non-geometric  entities  in  a simple  form 
but  also  provide  a way  to  describe  two  and  three  dimensional 
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Development  of  a high  level  language  that  provides 
these  features  can  be  approached  in  several  different  wavs. 
A set  of  graphic  functions  or  subroutines  can  be  developed 
to  be  used  bv  an  applications  program,  written  in  a hiah 
level  programming  language.  Another  approach  is  to  utilize 
the  high  level  I anguaoe  of  the  host  computer  and  extend  it 
to  perform  a variety  of  graphic  functions.  This  extension 
can  be  accomplished  bv  changing  the  existing  compiler  to 
handle  graphics  functions  or  by  developing  a preprocessor . 
If  a suitable  high  level  language  is  not  available  on  a sys- 
tem, then  the  development  of  a language  specifically  tor 
graphics  could  be  considered.  This  1 anguaqe  would  require 
not  only  the  develooment  of  graphic  functions  but  must  also 
provide  a 1 oo r i t hm i c - 1 yoe  statements,  procedures  or 
subroutine  capabilities,  and  should  be  interactive  I'M. 


The  goal  for  the  Vector  General  was  the  development  of  a 
high  level  general  Purpose  language.  The  UNIX  operating 
system  provided  the  high  level  1 anguage  C,  that  has  facili- 
ties for  handling  many  different  data  types,  adeauate  con- 
trol structures  and  data  structures  for  algorithm  represen- 
tation. It  also  provides  a simple  subroutine  calling  format. 
Because  of  the  availability  of  the  high  level  language  the 
develooment  of  a new  graphics  1 anguaqe  was  rejected.  The 
decision  was  to  either  incorporate  graphical  functions  into 
this  host  language  by  extending  the  language  or  by 
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developing  a subroutine  library  package.  In  general, 
several  reasons  can  be  stated  for  not  selecting  the 
subroutine  library  approach.  These  include  the  lack  of  con- 
venience of  usinq  subroutine  calls  exclusively,  inefficient 
data  structures  provided  by  the  host  language,  and  lack  of 
facilities  in  the  host  language  to  support  a wide  variety  of 
applications  fill.  The  C-language  provided  all  the  neces- 
sary facilities  and  convenience.  The  simplest,  and  most 
logical  approach  was  the  i mp 1 emen t a t i on  of  a high  level 
subroutine  package  utilized  bv  an  applications  program  writ- 
ten in  C . 


The  process  taken  in  developing  this  subroutine  library 
is  outlined  by  W.  M . Newman  and  R . F . Sproull  (121  : 


i 
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1.  Select  a suitable  language  on  which  to  base 
the  system. 

2.  Design  a set  of  functions  for  graphical 
incut  and  output. 

3.  Write  a programmer's  manual. 

R.  Write  the  software,  to  perform  the  graphic 
funct i ons  . 

This  approach  was  taken  to  insure  the  development  of  a user 
oriented  graphics  design  rather  than  one  that  was  merely 
easy  to  program  and  implement. 


I 
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8.  CONSIDERATIONS  FOR  A USER  ORIENTEO  DESIGN 

One  of  the  aoals  of  this  interactive  subroutine  liprary 
is  to  provide  a general  purpose  high  level  package  fhar  « i l ' 
support  a wide  variety  of  applications.  Additionally,  it  is 
important  that  the  system  be  user  oriented.  This  "ears  that 
the  resulting  graphics  programs  should  be  as  easy  to  write 
and  maintain  as  any  other  interactive  program.  The  design 
has  to  provide  a clear  and  vivid  means  of  describing  the 
pictures  a user  wants  to  create  1151. 

In  trying  to  produce  this  type  of  user  oriented  package 
several  requirements  have  to  be  met  by  the  design  spec i f i ca- 
tions. 

1.  Graphics  Primitives 

A graphics  system  should  orovide  a small  number  of 
powerful  graphics  primitives  [PI.  These  should  be  designed 
in  such  a way  that  the  user  is  required  to  concentrate  on 
the  picture  being  described  rather  than  on  the  hardware 
features  of  the  machine.  The  user  must  be  able  to  construct 
logical  picture  segments.  combine  them  into  a meaningful 
picture  and  then  manipulate  any  combination  of  these  picture 
segment  s (151. 

2.  Default  Parameters 

Default  parameters  should  be  skillfully  introduced 
into  the  system  (8).  This  eliminates  a novice  user  from  the 
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irritatinq  details  of  the  system. 
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If  default  values  are 


au t oma t i c a 1 1 y included/  a novice  user  can  concentrate  on  the 
oasic  problem  of  describing  a picture. 

5.  Error  Diagnostics 

User  parameters  should  be  checked  and  all  errors 
should  provide  informative  diaanostics.  Errors  should  only 
activate  diagnostic  routines#  and  they  should  never  force 
the  termination  of  a user  program  (10).  A user  should  be 
able  to  trace  and  correct  errors  with  a minimum  of  effort. 
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VECTOR  GENERAL  USER  INTERFACE  DESIGN 


The  desiqn  of  the  Vector  General  high  level  interface 
is  implemented  in  the  form  of  subroutine  library  functions 
which  are  utilized  through  proqrams  written  in  the  high 
level  language  C.  Every  effort  was  made  to  limit  the  number 
of  functions  without  limiting  the  hardware  caoabilities  of 
the  Vector  General.  The  design  of  this  primitive  set  is 
based  on  the  concent  of  picture  structure,  as  defined  by  the 
constructs  picture,  object  and  element. 

A.  PICTURE  STRUCTURE  AND  USER  ASSOCIATION 

The  present  interface  provides  the  capability  of 
describing  pictures  as  a collection  of  objects  with  associ- 
ated elements  and  attributes.  The  framework  for  this  topi- 
cal description  of  a picture  and  the  implementation  of  a 
structured  display  file  is  orovided  by  the  existing  inter- 
face. This  is,  however,  inadequate  because  within  this 
framework  a user  cannot  easily  generate  the  actual  display 
instructions  that  make  up  each  element.  Additional  capabil- 
ities for  easily  describing  a logical  picture  element  and 
its  association  with  other  elements  and  with  the  picture  is 
orovided  by  the  design  described  here. 


k. 
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The  implemented  aesign  introduces  the  concept  o*  an  ele- 
ment block.  An  element  block  consists  of  a series  of  move- 
draw  instructions  or  of  ASCII  character  data.  This  approach 
provides  a flexible  wav  for  clearly  isolating  and  naminq 
specific  picture  segments.  Additionally  the  responsibility 
of  dimensionina  arrays  for  each  element  display  list  is 
removed  from  the  user  and  is  instead  managed  by  the  software 
interface.  This  dynamic  allocation  and  manaoement  of  display 
lists  by  the  software  interface  greatly  extends  the  flexi- 
bility of  an  element  block.  Each  element  block  can  contain 
not  only  graphic  functions  but  any  of  the  C-l anquage  arith- 
metic# conditional  or  logical  statements#  as  well  as 
subroutine  calls.  A user  can  also  define  a graphical  entity 
within  an  element  block  recursively. 

any  problem  solutions  are  most  appropriately  defined  in 
recursive  terms.  wirth  sites  several  examoles  of  graphic 
patterns  that  are  most  easily  described  by  a recursive  algo- 
rithm (151.  The  cacability  of  defining  elements  by  recur- 
sive algorithms  provides  the  user  with  another  powerful 
tool. 

In  addition  to  the  element  block  structuring#  a primi- 
tive is  provided  so  that  the  user  can  easily  establish  the 
desired  element#  object  relationships.  This  provides  an 
easy  and  concise  method  for  loaically  constructing  a pic- 
ture. With  this  primitive  any  number  of  element  blocks  can 
be  associated  wtth  an  object  at  one  time  or  at  several  dif- 
ferent times  within  a proaram. 
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B.  SELECTING  NON-LIMITING  PRIMITIVES 


The  Vector  General  provides  12  different  vector  types* 
arcs*  circles*  ASCII  characters  and  has  the  facilites  for 
creating  three  dimensional  images.  Incorporating  the  flexi- 
bility of  12  vector  types  and  two  or  three  dimensions  within 
a limited  set  of  graphic  functions  presents  several  prob- 
lems. The  hardware  capabilities  of  the  Vector  General  must 
be  available  to  a hiqh  level  user  in  a concise  and  logical 
manner.  Extending  the  function  set  to  include  separate  func- 
tions for  each  vector  type  and  for  two  or  three  dimensions* 
is  not  appealing  because  it  provides  a user  with  too  many 
opportunities  for  meaningless  and  erroneous  operations  1123. 
The  other  possibility  is  to  use  variable  lenqth  parameter 
lists  for  a small  function  set.  The  C-l anauaoe  supports  the 
use  of  varible  length  parameter  lists  and  this  approach  is 
implemented  without  compromisina  other  factors  such  as  ease 
of  use*  simplicity*  and  understanding.  This  approach  lead 
to  the  development  of  nine  functions  which*  in  combination* 
allow  utilization  of  all  of  the  Vector  General  facilities  in 
creating  an  element  block  and  establish  the  desired  object* 
element  linking.  A complete  description  o*  these  functions 
can  be  found  in  Appendix  A. 
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C.  NAMING  CONVENTION 


I 


The  constructs  object*  element  and  oicture  provide  a 
multi-level  naming  structure  [l^J.  This  structure  allows  a 
user  to  associate  integer  names  with  each  object  and  element 
that  is  created.  These  integer  names  are  assigned  values  bv 
the  user  interface.  Additionally  each  element  is  also  asso- 
ciated with  an  array  name.  This  naming  convention,  which 
reguires  use r- i n t e r f ac e interaction  is  inaaeguate  for  a high 
level  interface.  A naming  convention  that  allows  a user  to 
independently  assign  meaningful  names  to  objects  and  ele- 
ments is  reouired.  The  high  level  interface  design 
described  here  provides  a simple  naming  process  which 
reguires  a user  to  specify  an  element  or  object  name  as  a 
ouoted  character  string  within  a parameter  list.  A name  is 
associated  with  each  element  and  object  as  they  are  created 
by  the  user.  There  are  no  limitations  imposed  on  the  user 
in  assigning  names  exceot  tha»  each  name  must  be  unigue. 
Each  object  and  element  name  is  used  throughout  the  program 
to  reference  a specific  oicture  segment.  This  implementa- 
tion provides  a flexible  and  easy  method  for  a user  to  asso- 
ciate meaningful  names  with  each  object  and  element. 

The  existing  interface  supports  the  concept  of  shared 
display  code*  thus  allowing  for  the  repetition  of  an  element 
in  a picture.  This  repetition  is  accomplished  by  associat- 
i ng  an  element  with  several  objects  or  with  one  object 
several  times.  This  latter  case  reaui res  that  a user  be 
able  to  uniguely  reference  each  occurrence  of  an  element 


2d 


within  a specific  object 


The  naming  convention  had  to  be 
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extended  to  handle  this  situation.  A primitive  has  been 
designed  that  allows  a user  to  assiqn  any  number  of  uniaue 
aliases  to  a specific  element  block.  An  element  can  be 
associated  with  an  object  several  times*  each  association, 
however,  is  established  by  usina  an  alias.  In  this  way  each 
occurrence  of  an  element  within  a specific  object  can  be 
uniauely  referenced  by  its  alias. 

D.  ERROR  DIAGNOSTICS 

All  functions  and  user  routines  provide  error  checking 
and  diagnostic  information.  An  error  will  never  cause  the 
termination  of  the  user's  program.  Every  effort  is  made  to 
allow  a user's  program  to  run  to  completion,  so  a user  will 
receive  some  visual  feedback  from  the  Vector  General  display 
screen.  A picture,  even  one  that;  results  from  several 
errors  can  act  as  a useful  debugging  aid  in  itself. 

E.  HIGH  LEVEL  USER  ROUTINES 

In  order  to  provide  a comprehensive  graphics  package, 
the  naming  convention  and  picture  structure  concept  has  to 
be  applied  to  the  lower  level  user  routines  that  dynamically 
change  and  manipulate  picture  seqments.  These  routines  are 
incorporated  into  this  hiah  level  structure.  when  possible 
several  low  level  routines  are  combined  to  provide  the  user 
with  a simpler  and  yet  more  powerful  routine.  For  example, 
separate  routines  for  the  deletion  of  an  object  and  element 
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fro"'  the  display  screen  are  provided  at  the  lower  level 


1 


These  two  routines  are  combined  into  one  routine  that  erases 
the  entire  picture#  an  object#  or  any  number  of  elements 
associated  with  a specific  object.  Additionally#  a routine 
is  included  so  a user  can  not  only  erase  an  element  block 
but  also  free  up  the  memory  locations  associated  with  the 
e 1 ement  block.  , 

The  advantaaes  of  allowing  a user  to  manipulate  display 
list  storage  lies  in  the  fact  that  it  is  extremely  difficult 
for  the  software  interface  to  determine  which  display  list 
structures  are  no  longer  reouired  and  should  be  removed. 
The  user  on  the  other  hand  knows  precisely  when  a specific 
item  is  no  longer  needed  f 161.  The  system  makes  available  a 
finite  area  for  the  creation  of  display  lists.  Erasina  an 
element  does  not  release  memory.  Elements  still  exist  and 
can  be  reassociated  with  the  picture  at  anytime.  The  user 
should  have  the  ability  to  optimize  this  storage  area#  by 
releasing  elements  that  are  no  longer  required.  This  is 
particularly  important  when  a user  program  exceeds  the  allo- 
cated display  list  storage.  Only  by  selectively  removing 
elements  from  memory  and  releasing  the  related  memory  loca- 
tions can  new  elements  be  created.  A user  can  extend  the 
systems  storage  limitations  bv  efficiently  managina  the 
display  list  storage  area. 
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VI 


RECOMMENDATIONS 


The  implemented  Graphics  subroutine  library  provides  a 
general  purpose  interactive  graphics  package.  The  routines 
provided  for  usinq  the  external  display  control  devices  are 
adequate)  but  can  be  extended  to  provide  a simpler  package 
for  a user.  For  example.  the  routines  that  control  the 
function  switches  and  the  function  switch  lamps  could  be 
combined  to  provide  a simpler  interface.  A varietv  of 
routines  for  utilizing  the  light  pen  should  be  available  to 
a user.  For  example,  a light  pen  trackino  routine  would  ben- 
ifit  the  system. 
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VII.  CONCLUSION 


The  hiah  level 

genera  1 

purpose 

graphics  subrouti 

ne 

library  discussed 

in  this 

thesis  is 

ooe  r at i ona 1 . 

I n i t i 

a 1 

test 

programs  indicate  that  the  system 

does  provide 

a s i 

m- 

o 1 e » 

but  powerful 

acproac h 

for  the  development  of 

i nterac- 

t i v«  graphics  proarams. 
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APPENDIX  A:  USER  REFERENCE  MANUAL 


I.  INTRODUCTION 


The  vector  general  is  an  interactive  graoMcs  display 
system  which  has  been  interfaced  with  the  PDP-11/S0  comput- 
er. The  display  interacts  with  a PDP-11  user  by  displaying 
pictorial  information  on  the  surface  of  a cathode  ray  tube 
and  by  accenting  information  from  its  external  control  dev- 
ices. The  external  devices  consist  of  an  alphanumeric  key- 
board# 32  lighted  function  switches#  10  control  dials#  and  a 
light  pen.  Through  a C-callable  interactive  graphics  program 
library#  the  pictorial  information  desired  by  a user  can  oe 
descrioed#  altered  and  manipulated.  This  manual  will  not 
discuss  in  detail  the  electronic  functions  of  the  vector 
general#  or  the  vector  general's  interface  with  the  PDP-11. 
The  purpose  of  this  manual  is  to  instruct  a user  in  the 
creation  and  manipulation  of  pictorial  data  on  the  vector 
general  display. 

This  manual  describes  the  use  of  a C-callable  interac- 
v tive  graphics  program  library.  A knowledge  of  the  C- 
programming  language  is  assumed.  The  user  is  also  directed 
to  Appendix  8 for  a brief  description,  calling  format  and 
error  diagonistic  information  on  each  of  the  user  interface 
rout i nes . 
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II.  THE  VECTOR  GENERAL  DISPLAY  SYSTEM 


A more  detailed  discussion  of  the  vector  aeneral  can  be 
found  in  the  Users  Manual  for  the  Vector  General  Display 
Unit  (t>l  and  the  Desion  MarMja)  for  the  Vector  General 
Display  Unit  151. 

A.  THE  DISPLAY 

The  vector  general  is  a cathode  ray  tube  (CPT)  display 
on  which  a visible  pattern  can  be  created  by  the  movement  of 
an  electron  beam.  The  electron  beam  causes  a f 1 orescent 
soot  to  aooear  on  the  face  of  the  display  tube.  The  move- 
ment of  the  beam  is  controlled  by  a method  called  random 
scan,  which  in  effect  steers  the  soot  in  a straiaht  line 
Detween  two  points  on  the  display  screen.  The  resulting 
line  or  vector,  combined  with  others,  creates  a picture  or 
pattern  on  the  display  screen. 

To  maintain  a clear  Dicture  on  the  display  screen  re- 
quires that  the  pattern  be  redrawn  on  the  tube  repeatedly  at 
approximately  thirty  to  forty  times  a second.  Each  repeti- 
tion is  called  a frame  and  the  frequency  at  which  it  is 
redrawn  is  called  the  refresh  rate.  If  the  pattern  is  not 
repeated  often  enough,  or  more  information  than  can  be 
redrawn  in  a frame  is  displayed,  a distortion  of  the  Picture 
will  occur  on  the  display  screen.  This  distortion  is  called 
f 1 icker, 
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8.  HARDWARE  FEATURES 

The  system  has  several  hardware  features*  in  addition  to 
a vector  qenerator,  which  greatly  extends  its  capaoilites. 
These  include*  the  ability  to  produce  three  dimensional  fig- 
ures* an  ASCII  character  set*  and  the  hardware  generation  of 
arcs  and  circles.  Other  features  provide  the  hardware 
mechanisms  for  the  rotation  and  translation  of  user  speci- 
fied picture  segments.  These  hardware  features  are  con- 
trolled and  coordinated  by  the  display  controller.  The  con- 
troller is  responsible  for  handlinq  the  communications 
oetween  the  user  interface*  the  external  control  devices  and 
the  display  hardware. 

The  main  purpose  of  the  external  control  devices  is  to 
facilitate  user  interaction  with  the  display.  These  devices 
include  an  alphanumeric  keyboard*  32  liahted  function 
switches*  10  control  dials  and  a light  pen. 

Additional  information  on  the  vector  general  hardware 
can  be  found  in  the  Graphics  Display  Reference.  Manual  Cl) 
and  the  Graphics  Display  System  Technical  Manual  13]. 

C.  THE  SYSTEM  INTERFACE 

A vector  qeneral  user  defines  pictorial  data  and  its 
manipulation  within  a C-l anquage  program.  The  execution  of 
the  program,  on  the  PDP-11/50,  causes  the  vector  general 
software  interface  to  be  activated.  It  is  this  software 
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D.  INTERFACE  WITH  EXTERNAL  DEVICES 

Each  of  the  the  external  interactive  devices  communicate 
directly  to  the  vector  oeneral  controller.  Information  from 
these  devices  is  returned  to  the  user  via  the  controller  and 
the  user  interface.'  The  user  program  may  utilize  the  infor- 
mation returned  from  these  devices  to  control  oroqram  floe. 
This  allows  a user  to  interactively  control  and  manipulate 
the  pictorial  information  at  display  time.  Specific  user 
routines  which  activate  these  external  devices  and  provide  a 
communications  channel  with  the  user  are  discussed  in  detail 
in  later  sections  of  this  manual. 

1.  Alphanumeric  Keyboard 

The  alphanumeric  keyboard  allows  the  user  *o  input 
information  in  the  form  of  ASCII  character  codes.  Through 
the  user  interface  the  user  can  display  the  information  on 
the  vector  general  disolay  screen.  The  data  entered  from 
the  keyboard  can  also  be  returned  to  the  user  proaram  for 
process i na . 

2.  Function  Switches 

The  12  liahted  function  switches  provide  the  user 
with  information  which  can  be  used  to  interactively  manipu- 
late pictorial  data  at  disolay  time.  Each  function  switch 
can  be  assianed  specific  meanina  by  the  user  program.  The 
user  interface  returns*  from  the  controller  to  the  user* 
information  on  which  function  switches  have  been  pressed.  A 
user  proaram  could  use  this  information  to  selectively 
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rotate*  translate  or  oerhaos  scale  particular  picture  seg 


i>ent  s . 

1.  Control  Dials 

The  10  control  dials  provide  numeric  information  to 
the  display  controller,  specifying  the  degree  to  which  each 
dial  has  been  turned.  This  information*  throudh  the  user 
interface*  can  be  provided  to  the  user.  A user  orogram  may 
utilize  the  values  of  the  variable  control  dials  in  deter- 
mining the  distance  or  rate  at  which  a oortion  of  the  pic- 
ture may  be  moved  or  rotated. 

a . Light  Pen 

The  light  pen,  a wand  containing  a photo  cell*  can 
be  used  to  se'ectively  point  to  different  picture  segments 
on  the  display  screen.  The  interface  provides  a user  pro- 
gram with  information  on  which  picture  segment  was  pointed 
to  by  the  liaht  oen.  A user  program  can  turn  the  liaht  oen 
se 1 ec t ab i 1 i t y of  soec i f i c picture  segments  on  or  off.  For 
example*  an  interactive  user  might  select  sections  of  a pic- 
ture for  erasure  by  pointing  to  them  with  the  light  pen. 

III.  INITIALIZATION 
A.  INTERFACE  INITIALIZATION 

The  vector  general  display  system  and  the  interface 
software  with  the  PDP-11  must  be  initialized  before  any  data 
can  be  displayed.  The  i ni t i al i zat i on  routine  sysinit  must 
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be  called  before  any  other  routines  are  utilized.  This 
routine  sets  all  the  system  default  oarametersi  such  as  the 
screen  coordinate  system. 

If  for  some  reason  the  i n i t i a 1 i z a t i on  cannot  be  complet- 
ed the  user  program  will  be  terminated.  This  error  usually 
occurs  because  another  user  is  accessing  the  vector  general. 

B.  display  initialization 

1.  Coordinate  System 

The  user  can  specify  a two  or  three  dimensional 
cartesian  coordinate  system,  of  any  scale.  All  disDlay  coor- 
dinate values  referenced  by  the  user  will  be  interpreted 
according  to  this  coordinate  system  definition.  A user  may 
redefine  the  coordinate  scale  at  any  time  in  a program.  The 
user  will  define  the  coordinate  svstem  in  a call  to  the 
routine  coordsys. 

coordsys(dim,minx,maxx,miny,maxy  f,minz,maxzJ  ); 

The  routine  reauires  the  user  to  specify  if  the  coordi- 
nate system  is  to  be  two  or  three  dimensional  and  the  range 
of  each  coordinate.  If  the  parameter  dim  is  two,  indicatina 
a two  dimensional  coordinate  system  is  desired,  the  range  of 
the  z coordinate  can  be  omitted,  and  will  be  ignored  if  it 
should  be  included. 

If  this  routine  is  not  called  by  the  user  the  default 
coordinate  system  will  be  used.  This  default  system  is 
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defined  as  three  dimensional  with  the  x * y*  z coordinates 
ranging  from  -100.0  to  100.0.  All  coordinate  values  will  be 
interpreted  by  this  default  system  when  coordsys  is  not 
called  by  the  user. 

2 . Picture  Scale 


The  rectanqul ar 

9 

1 3 by 

14 

inch. 

portion  of 

the 

display 

sc  reen  that  can 

be 

v i ewed 

by 
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user 
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visible 
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m u m 

picture  soace 
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larger  than 
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visible 
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a" 

area  of 

30 

by 

30 

inches. 

This 

extra  area  allows  a user  to  rotate  or  move  part  of  the  pic- 
ture to  the  extreme  boundries  of  the  visible  space  without 
any  distortion.  It  also  permits  limited  zoominq. 

The  pictorial  data  beinn  displayed  can  be  adjusted  in 
size*  or  scaled*  bv  two  different  controls.  One*  the  gain 
control  dials  on  the  vector  neneral  display  unit  allow  the 
user  to  manually  "anicu’afe  t h e picture  scale.  The  second 
provides  scale  control  within  the  user's  orogram  by  callina 
the  routine  vaoscal.  This  routine  is  discussed  in  detail  in 
Section  V of  this  manual. 


TV.  CREATING  A PICTURE 


A.  PICTURE  STRUCTURE 

All  of  the  information  that  a user  desires  to  display  on 
the  vector  general  must  be  incorporated  into  the 
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hierarchical  picture  structure  defined  by  the  user  interface 


packaqe.  The  three  hierarchical  levels  are  defined  as:  pic- 
turei  object*  element.  These  levels  soecify  the  underlying 
structure  of  the  araohical  disolay  and  determine  the  opera- 
tions a user  can  perform  on  information  associated  with 
each  level. 

The  term  picture  refers  to  all  of  the  data  that  is  to  be 
displayed  on  the  vector  general  display  space.  The  term 
element  refers  to  the  smallest  picture  segment  which  can  be 
independently  referenced  and  changed  without  affecting  the 
remainder  of  the  picture.  Each  element.,  or  independent  pic- 
ture segment,  has  a uniaue  name  associated  with  it.  A col- 
lection, or  meaningfull  grouping,  of  elements  is  called  an 
object.  Each  object  is  also  labeled  by  a unique  name  so  it 
can  be  easily  reference d by  a user.  Figure  A-?  illustrates 
the  relationship  of  the  three  levels  in  the  actual  structure 
of  a picture. 

An  element  is  completty  described  and  named  by  the  user. 
It  can  describe  either  graphical  or  ASCII  character  data. 
An  element  can  be  independently  added  or  erased  from  the 
disolay  screen.  It  can  be  caused  to  blink  or  be  specified 
as  being  liqht  oen  selectable. 

Each  element  must  be  associated  with  at  least  one  object 
before  it  can  be  displayed  on  the  vector  qeneral.  An  object 
can  consist  of  one  or  more  elements.  A user  is  reponsible 
for  establishing  the  desired  ob j ec t -e 1 emen t association. 
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PICTURE 


OBJECT  1 0RJECT2  OBJECT3 


ELEMENT  1 ELEMENT?  ELEMENT?  ELEMENT  a 


Hierarchical  Picture  Structure 


ETruRE  P-2 


ana  ♦or  speci fyina  a unique  name  for  each  object.  Each  user 


defined  object  can  be  independently  rotated,  or  translated 
to  any  section  of  the  30  by  30  inch  display  space.  An  ob- 
ject can  be  added  or  erased  from  a picture,  scaled,  and 
specified  to  blink  or  to  be  light  pen  selectable.  Each 
object's  intensity  can  be  varied  in  order  to  give  three 
dimensional  objects  their  depth  queuing.  These  actions,  when 
applied  to  a specific  object,  a Meet  every  element  that  has 
been  associated  with  it  by  the  user. 

A picture  can  contain  one  or  more  objects.  The  coordi- 
nate scale  and  picture  scale  defined  by  the  user  affects  the 
entire  picture.  A picture’s  coordinate  scale  can  be  varied 
but  this  action  will  affect  every  object  defined  as  part  of 
the  picture.  An  entire  picture  can  also  be  erased,  speci- 
fied to  blink  or  he  light  pen  selectable. 

A summary  of  the  operations  for  each  level  of  the 
hierarchy  is  outlined  in  Figure  A-3. 

B.  CONSTRUCTING  AN  ELEMENT 

Every  element  is  completely  described  bv  the  user  within 
an  element  block.  There  are  two  types  of  element  blocks.  A 
draw  element  block,  describes  graphical  information.  The 
other,  a character  element,  describes  ASCII  characters  that 
are  to  be  displayed.  Each  element  is  uniauely  named  and 
this  name  will  be  used  to  reference  this  particular  struc- 
ture. 
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PICTURE  : 

Define  picture  coordinate  system 

Picture  scale 

Erase 

Remove 

Blink 

Light  pen  selectable 

OBJECT  : 

Translate 
Rotate 
Sea  1 e 

Intensity  scale 
Intensity  offset 

Erase  * 

Remove 

Blink 

Light  pen  selectable 

ELEMENT: 

Erase 

Remove 

Blink 

Light  pen  selectable 

Summary  Operations  Associated  with  Each  Hierarchial  Level 

FIGURE  A-3 
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Draw  Element  Block 


A draw  element  block  represents  a group  of  draw 
instructions  that  describe  a specific  structure,  or  picture 
segment.  These  draw  instructions  include  setvector,  move, 
line,  arc  and  circle.  A draw  element  block  becjins  with  a 
call  to  the  routine  drawele  and  is  terminated  by  a call  to 
tre  routine  endele.  The  draw  instructions  that  are  executed 
between  drawele  and  endele  describe  the  actual  picture  seg- 
ment. 

The  only  parameter  required  by  drawele  is  a quoted  char- 
acter string,  or  pointer  to  a character  strina,  specifying 
the  name  the  user  wants  to  associate  with  this  element. 
This  name  will  be  used  throughout  the  oroaram  to  reference 
this  el emen t block. 

The  basic  draw  element  block,  and  the  related  draw  in- 
structions are  represented  in  the  following  format: 

--  drawe 1 e ( "e 1 ement -name"  ) ; 

! setvector(vtyce,vTode,  line)  , Iscalel  ) i 

I 

• • 

I 

I • 

I 

I • 

! — -setvector(vtyoe»vmode»  (inc) , (scale)  ); 

! | move(x,tyl,(zl); 

J ! line(x,tvl,(zl); 

! ! c i rc 1 e ( d i r , cent x , (cent y 1,  (cent z)  ) ; 

! ---  arc(dir,centx,  (centvl  , (centzl  ,endx,  [endvl  , lendzl  ),’ 

I 

• • 

» 

I • 

I 

• • 

ende 1 e ( ) » 

The  user  can  select  one  or  more  of  the  twelve  vector 
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tyoes  in  constructing  an  element 


T hese  vector 


tyoes 


descrioe  how  the  coordinate  data  will  be  interpreted  in 
drawing  a vector  on  the  display  screen.  The  choice  of  a vec- 
tor effects  the  parameters  that  will  be  passed  in  each  of 
the  move#  line#  circle  or  arc  instructions.  The  user  speci- 
fies a vector  selection  by  callina  the  routine  setvector. 

a.  setvector  - This  draw  instruction  must  be  called 
immediately  after  drawele#  and  may  be  called  any  number  of 
times  within  the  element  block,  fcach  setvector,  and  the  draw 
instructions  that  follow  it#  comprise  a subgroup.  The  set- 
vector  instruction  aeterni nes  the  manner  in  which  the  line# 
move#  arc  ana  circle  instructions  in  the  subaroun  will  be 
interpreted#  as  well  as  their  visual  appearance  on  the 
Display  screen.  The  routine  is  called  with  the  following 
pa  r ame  t e r s : 


setvector(vtype#vmode  C#incl  t#scale)  1; 

The  Parameter  vtype  specifies  which  one  of  the  twelve 
vector  types  the  user  wants  the  following  group  of  line# 
move#  arc  and  circle  instructions  to  utilize.  The  parameter 
vmode  indicates  the  vector  mode#  or  appearance  of  the  vec- 
tors to  be  drawn  (ie#  solid  line#  dotted  line#  etc.).  Cer- 
tain vector  tyoes  require  additional  information#  this  in- 
formation is  specified  by  the  parameters  i nc  and  scale. 
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TABLE  A-I 

SUMARY  OF  VECTOR  TYPES 


NAME  DESCRIPTION 

V A - vector  aosolute*  each  coordinate  is  specified 
with  resoect  to  the  origin.  Each  point(x,y,z) 
references  a unique  point  on  the  display  screen. 

VAX  - vector  absolute  auto*increrent  x,  every  draw 
instruction  causes  the  y and  z absolute 
values  to  be  updated  while  x is  stepped  by  a 
constant  value. 

VAY  - vector  aosolute  auto*increment  y*  every  draw 
instruction  causes  the  x and  z absolute 
values  to  be  updated  while  y is  stepped  by  a 
constant  value. 

VAZ  - vector  aosolute  auto-increment  z*  every  draw 
instruction  causes  the  x and  v absolute 
values  to  be  undated  while  z is  stepped  by  a 
constant  value. 

VR  - vector  rel at i ve»  each  x*  y*  z coordinate 
value  indicates  the  amount  that  is  to  be 
added  or  subtracted  from  the  previous  absolute 
coordinate  Point. 

VRX  - vector  relative  auto-increment  x*  each  draw 

instruction  causes  the  y and  z coordinate  values 
to  be  incremented  by  the  specified  value  while 
x is  stepped  by  a constant  value. 

VRY  - vector  relative  auto-increment  y*  each  draw 

instruction  causes  the  x and  z coordinate  values 
to  be  incremented  bv  the  specified  value  while 
y is  stepped  by  a constant  value. 

VRZ  - vector  relative  auto-i nc rement  z,  each  draw 

instruction  causes  the  x and  y coordinate  values 
to  be  incremented  by  the  specified  value  while 
z is  stepped  by  a constant  value. 
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TABLE  A - I 
(coot i nued) 


INC2-  two  dimensional  incremental  vector,  a 

relative  vector  that  optimizes  storage  re- 
quirements. The  coordinate  increment  values 
are  limited  to  values  approximately  3%  of  the 
user's  coordinate  range. 

INCX-  two  dimensional  incremental  aut o- i nc rement  x, 
is  a relative  vector  that  optimizes  storaqe 
requirements.  The  y coordinate  value  is 
incremented  by  a small  value  while 
x is  stepped  by  a constant  value. 

INCY-  two  dimensional  incremental  aut o- i nc rement  y# 
is  a relative  vector  that  optimizes  storaqe 
requirements.  The  x coordinate  value  <s 
incremented  by  a small  value  while 
y is  stepped  by  a constant  value. 

INC  3-  three  dimensional  incremental  vector,  a 

relative  vector  that  optimizes  storage  re- 
quirements. The  x,  v,  z coordinate  increment  values 
are  limited  to  values  that  are  aoo r o * i ma t e 1 y 3% 
of  the  user's  coordinate  range. 


UU 


A brief  summary  of  the  twelve  vector  types  is  listed  in 
Table  A-I,  a more  detailed  account  of  each  vector  type  and 
the  parameters  required  bv  setvector  are  listed  in  Appendix 
B.  Figure  A-0  illustrates  the  five  different  vector  modes 
that  are  available. 


VECTOR  MODE  PARAMETER  VALUE 


VISUAL  APPEPANCE 


1 i ne 

LN 

/ 

00 

dashed 

DSH 

/ 

020 

dotted  line 

DOT 

/ 

oao 

end  point 

PNT 

/ 

060 

dash-dot -dash 

DO 

/ 

0120 

dash-dot -dash 

non 

/ 

0 1 oo 

Vector  Modes 
FIGURE  A-« 


b.  move  - The  draw  instruction  move  is  used  to 
reposition  the  beam  on  the  display  screen.  It  will  produce 
no  visible  line  or  pattern.  The  format  of  the  instruction 
i s : 


movelx  C » y I 

The  coordinate  values  x»  vr  z will  be  either  absolute  or 
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relative  values.  The  vector  tyoe  selected  in  the  proceed- 
ing setvector  instruction  will  determine  how  the  value  of 
these  parameters  will  be  interpreted.  The  bracketed  values 
indicate  parameters  that  may  be  optional. 

If  the  user  coordinate  system  is  not  three  dimensional? 
the  z parameter  can  be  omitteo,  ana  will  be  igr.orea  if  it 
should  te  irclucec. 

c.  line  - The  line  instruction,  draws  a visible 
line  or  vector  on  the  display  screen.  The  line  is  drawn 
from  the  present  beam  locaton  to  the  specified  end  point. 
The  format  of  the  instruction  is: 

linefx  t,y)  C , z ] ) : 

The  coordinate  values  x,  v,  z will  be  either  absolute  or 
relative  values.  The  vector  type  selected  in  the  previous 
setvector  determines  how  the  value  of  these  parameters  will 
be  interpreted. 

If  the  user  has  defined  a two  dimensional  coordinate 
system,  the  z parameter  can  be  omitted,  and  will  be  ignored 
if  it  should  be  included. 

d.  circle  - The  circle  instruction  will  draw  a cir- 
cle beginning  at  the  present  beam  location  about  the  center 
point  specified  by  the  user.  The  difference  between  the 
present  beam  location  and  the  center  point  determines  the 
radius  of  the  circle.  The  instruction  is  used  by  the  fol- 
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lowing  format 


c i rc 1 e (d i r > cent x [,eenty]  l,centzl) 


The  parameter  dir  indicates  in  which  direction  the  cir- 
cle is  to  be  drawn,  clockwise  or  counterclockwise.  The 
number  of  parameters  required  and  their  values  are  deter- 
mined bv  the  vector  t vpe  selected  in  the  previous  setvector 
instruction.  A circle  cannot  be  drawn  bv  any  of  the  four 
incremental  vectors. 

If  the  user  coordinate  system  is  two  dimensional,  the  z 
parameter  can  be  omitted,  and  will  be  iqnored  if  included. 

e.  arc  - The  arc  instruction  will  draw  an  arc  from 
the  present  beam  location,  about  the  specified  center  point, 
to  the  desired  end  point.  The  distance  between  the  startinq 
point  and  the  center  point  determines  the  radius  of  the  arc 
being  drawn.  The  instruction  format  is  : 

a rc ( d i r , c en t * t»centvl  [ , cent z 1 , end*  l,endyl  [,endz])J 

The  parameter  dir,  qives  the  direction  the  arc  is  to  be 
drawn,  clockwise  or  counterclockwise.  The  coordinate  values 
are  determined  by  the  vector  type  selected  in  the  previous 
call  to  setvector.  An  arc  cannot  be  drawn  by  any  of  the  four 
incremental  vectors. 

If  the  user  coordinate  system  has  been  defined  as  two 
dimensional,  the  z parameters  can  be  omitted,  and  will  be 
iqnored  if  included. 

If  the  distance  from  the  startinq  point  of  the  arc  to 
the  center  point,  and  the  distance  from  the  end  point  to  the 
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center  point  are  not  equal/  the  resulting  arc  will  contain  a 


straight  line.  The  straight  line  results  from  the  arc  gen- 
erator trying  to  compensate  for  the  two  different  distances 
to  the  center  point.  One  distance  will  be  used  to  determine 
the  radius  of  the  arc*  the  arc  will  then  be  drawn  using  this 
radius.  The  arc  will  stop  at  the  systems  new  defined  end 
point  and  a straight  line  will  be  drawn  to  the  end  point 
that  had  been  specified  by  the  user.  The  resulting  arc  ap- 
pears in  the  following  form: 


<? . Character  Element 

A character  element  represents  ASCII  character  data  that 
is  to  be  incorporated  into  the  picture  structure.  A user  can 
specify  a character  element  containina  ASCII*  special  vector 
general  characters  and  formatting  symbols  to  be  displayed  on 
the  vector  general  display  screen.  A user  can  select  from 
four  character  sizes  and  has  the  option  of  selecting  a 
slanted  character  set.  The  text  can  be  displayed  horizon- 
tally or  vertically  on  the  screen.  The  vertical  position 
causes  the  characters  to  appear  as  if  they  were  on  a page 
that  had  been  rotated  ninety  degrees  counter  clockwise.  The 
user  can  select  the  position  on  the  screen  where  the  string 
is  to  begin*  or  can  output  it  relative  to  the  present  beam 
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dos i t i on . 

Each  character  element  is  given  a unique  name  by  the 
user.  This  name  will  allow  the  user  to  easily  reference 
each  character  element.  A character  element  is  represented 
by  the  following  format: 

charele("element-name"»st  ring, si z e * wd i r,sl ant  * x , y ) ; 

The  parameter  string  can  be  either  a quoted  string 
within  the  parameter  list  or  a pointer  to  a character  strinq 
or  array.  The  character  strinq  will  begin  at  the  point (x,y) 
or  can  be  output  relative  to  the  present  beam  location  by 
replacing  the  * and  y parameter  with  the  constant  VGPEL. 
For  example*  the  followina  character  element,  when  linked  to 
an  object*  would  be  output  relative  to  the  present  beam 
position; 

charele(,,element“nameH*"Mow  is  the  time"*SZ/4*H0B,FLNT,VGREL); 

A summary  of  the  character  element  parameters  is 
presented  in  Table  A-II,  The  character  set  available  on  the 
vector  general  is  illustrated  in  Fiaure  A-5,  All  of  the  vec- 
tor qeneral  characters  can  be  represented  within  a character 
string.  The  special  formattina  symbols  and  symbols  for  the 
special  vector  general  characters  are  listed  in  a Appendix 
8. 
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table  a-ii 

SUMMARY  of  character  ELEMENT  PARAMETERS 
size:  specify  character  size 

SZ  / 00  - use  previously  defined  character  size 


SZ1 

/ 

01  00 

- set 

size 

t o 

100 

Col  limns 

by 

60 

lines 

SZ2 

/ 

0120 

- set 

size 

t 0 

81 

Co'  U"ins 

by 

«1 

lines 

SZ  3 

/ 

oiuo 

- set 

size 

t o 

60 

CO  1 u*ns 

by 

30 

lines 

sz« 

/ 

0160 

- set 

size 

t 0 

32 

Col  unnns 

b v 

1 6 

lines 

wd i r : 

write 

d i r ec  t ion 

HOP  / 

00 

- write 

characters 

hori zontal 1 y 

VER  / 

0200 

- write 

charac t ers 

vertically 

slant'  specifies  regular  or  slanted  characters 
SLNT  / 00  - slanted  characters 


NSLNT/  01 


regular  characters 


Character  Set 


FIGURE  A-5 


C.  LINKING  ELEMENTS  TO  OBJECTS 


Draw  and  character  elements  represent  the  smallest  pic- 
ture segment  that  can  be  independently  referenced  by  the 
user.  In  order  to  display  an  element  it  must  be  associated 
with  at  least  one  object.  fin  object  represents  the  smallest 
entity  that  can  be  displayed  independently  on  the  vector 
genera  1 sc  reen  . 


1.  Object  Routine 

Each  object  is  given  a unique  name  so  it  'can  be 
easily  referenced  by  the  user.  Elements  can  be  linked  to  an 
object  at  one  time  or  by  several  different  calls  to  the 
routine  called  object.  fin  object  can  consist  of  one  or  more 
elements.  fi  specific  element  can  be  linked  to  several  dif- 
ferent objects#  or  may  be  linked  to  one  object  several 
times.  This  ob j ec t -e 1 emen t association  or  linking  is  esta- 
blished by  the  routine  object.  This  routine  has  the  follow- 
i ng  format : 


object  (num,"object-name',»"element-naineM»  . . . » "element-name")  ; 

*. 

The  rarameter  num  indicates  the  number  of  elements  that 
are  to  be  linked  to  the  named  object  by  this  call.  The  ele- 
ments are  referenced  by  the  names  specified#  by  the  user#  in 
the  preceding  drawele  and  charele  routines.  Since  each  ob- 


ject is  assoc i a t ed 


with  a unique  name#  a second  call  to 


object*  with  a duplicated  object  name*  will  cause  the  ele- 


ments to  be  added  to  the  object  first  associated  with  that 
name . 

when  an  element  is  linked  to  a soecific  object  several 
times*  the  user  can  no  longer  reference  a soecific  oc- 
currence of  this  element  within  the  object*  for  example: 

object ( 3* "T  ree"* "branch" , "branch"  * "branch"  ) ; 

In  this  case  the  element  branch  has  been  linked  to  the 
object  tree  three  times.  when  displayed*  element  branch 
will  aooear  three  times.  Now  (however,  the  user  cannot 
uniquely  reference  a specific  occurrence  of  the  element 
branch.  If  the  element  called  branch  was  selected  to  be 
erased*  the  first  occurrence  of  branch  would  be  erased  from 
the  screen.  In  many  instances  it  may  desirable  to  uniquely 
reference  each  occurrence  of  an  element  within  a specific 
object.  This  can  be  accomplished  by  associating  several 
unique  names  with  an  element.  The  routine  copyele  provides 
this  c aoab i 1 i t y . 

2.  Copyele  Soutine 

This  rout  ire  allows  a user  to  assiqn  several  unique 
names  to  a soecific  element  structure.  In  this  way*  an  ele- 
ment structure  can  be  associated  with  an  object  several 
times  and  each  occurrence  can  be  uniquely  referenced.  The 
routine  is  represented  by  the  following  format: 
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copye 1 e ( num , "el e*ent*name 


coDvl*name"("copv?*name 


, • • • ) 


The  parameter  num  indicates  the  number  of  additional  names  a 
user  wishes  to  associate  with  the  named  element  structure. 
The  "el ement -name"  refers  to  a previously  defined  draw  ele- 
ment or  character  element  block.  Each  of  the  "cony-names" 
must  be  unique. 

Now  reconsider  the  previous  example.  If  the  element 
branch  is  associated  with  two  other  uniaue  names  and  these 
three  names  are  used  in  the  ob j ec t -e 1 emen t linkinq,  each 
occurrence  of  the  structure  can  now  be  uniquely  referenced 
by  the  user.  The  followinq  two  statements  will  accomplish 
this  task. 

copyele(2, "branch", "firanchl ", "branch^"); 
object (3, "tree", "branch ","branchl","branch2"); 

V.  DISPLAY  MANIPULATIONS 

A.  USER  ROUTINES 

After  the  user  has  incorporated  all  data  that  is  to  be 
displayed  into  the  desired  picture  structure,  it  can  now  be 
manipulated  and  transformed.  The  followinq  user  routines 
provide  the  means  to  manioulate  the  picture,  objects  and 
elements  that  have  been  created  by  the  user. 
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A descriotion  of  each  user  routine*  call inq  format  and 
error  diaqnostics  are  included  in  Appendix  B. 

1 . Blink 

The  disolay  blink  mode  can  be  set  for  the  entire 
picture*  single  object  or  for  any  number  of  elements  associ- 
ated with  a specific  object.  Modifying  the  blink  mode  of  an 
object  affects  all  the  elements  associated  with  that  object. 
The  routine  blink  will  turn  the  blink  mode  on  or  off  for  the 
specified  picture  segment. 

2 . Erase 

The  entire  picture*  a single  object  or  any  number  of 
elements  associated  with  a specific  object  can  be  erased 
from  the  display  screen.  The  picture  segments  that  are 
erased  from  the  screen  can  be  redisplayed  by  again  estab- 
lishing the  desired  object-element  association.  This  is 
accomplished  by  calling  the  routine  object*  as  described 
earlier.  Erasing  an  object  will  affect  all  elements  associ- 
ated with  the  named  object. 

3.  Input  Data  from  the  Display  Keyboard 

The  routine  indata  allows  a user  to  receive  and  out- 
put characters  from  the  vector  general  keyboard  onto  the 
disolay  screen.  The  ASCII  character  data  is  also  placed  in 
a user  specified  character  array  for  processing  by  the 
user's  program.  Up  to  one  line  of  text  can  be  entered*  data 
entry  is  terminated  by  a carriage  return.  The  termination 
of  the  data  entry  also  erases  the  output  characters  from  the 
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disc  lay  screen. 

u.  Intensity  Offset 

The  routine  intoffset  allows  the  user  to  vary  the 
intensity  level  of  a three  dimensional  object/  or  impose  a 
screen  cut-off  plane  for  the  named  object. 

5.  Intensity  Scale 

The  routine  intscale  allows  a user  to  vary  the  in- 
tensity of  a three  dimensional  object/  this  provides  the 
deoth-cueina  or  shading  for  a three  dimensional  object. 

6 . Light  Pen 

The  light  pen  se 1 ec t ab i 1 i t y of  the  picture/  a single 
object/  or  any  number  of  elements  associated  with  a specific 
object  can  be  turned  on  or  off  by  the  routine  called 
Ightoen.  This  determines  what  picture  segments  will  be 
affected  by  light  oen  interactions. 

7 . Remove 

The  routine  remove  provides  a user  with  the  ability 
to  release  the  memory  locations  associated  with  a specific 
element  structure.  The  user  can  remove  the  picture  and 
release  all  the  memory  locations  that  have  been  used  to 
describe  all  the  existing  elements.  Additionally  the  picture 
will  be  erased  from  the  screen.  Each  element  that  is  removed 
from  memory  can  no  longer  be  referenced  or  linked  to  ob- 
jects. An  individual  element  can  also  be  removed  from 
memory/  this  will  cause  every  occurrence  of  the  element  to 
be  erased  from  the  screen  and  the  memory  locations 
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associated  with  the  element's  description  will  be  released 


The  user  can  specify  an  element  for  removal  by  either  it's 
oriqinal  name  or  by  any  of  the  copy  names  associated  with 
it.  Remove  results  in  the  elimination  of  all  occurrences  and 
all  copies  of  an  element  from  the  display  screen.  A element 
that  has  been  removed  can  be  redisplayed  only  by  recon- 
structing the  element  block  and  by  aqain  establishing  th® 
desired  ob j ec t -e 1 emen t association. 

8 . Rotate 

This  routine  allows  a user  to  rotate  an  object  about 
the  x»  'it  and  z axis.  The  rotation  of  an  object  affects  all 
elements  associated  with  the  named  object.  Arcs.  circles 
and  characters  are  always  drawn  in  a plane  parallel  to  the 
screen^  and  are  rotatable  in  a three  dimensional  cooroinate 
system  about  the  z-axis. 

9 . Scale 

The  routine  scale  allows  a user  to  scale  indepen- 
dently any  object  of  the  picture.  All  elements  associated 
with  the  object  will  be  scaled  by  the  specified  scale  fac- 
tor. 

10.  Translate 

The  routine  trana  allows  the  user  to  move  an  object 
anywhere  in  the  display  space.  The  object  and  all  its  asso- 
ciated elements  can  be  moved  in  the  x,  y,  ana  z plane.  Con- 
tinually translating  an  object  by  very  small  increments  will 
cause  it  to  appear  as  if  it  is  movinq  across  the  display 
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screen.  The  following  example  will  move  the  named  object 
diagonally  across  the  display  screen: 

x = y = .01  //coordinate  system  is  2D 
//ranqing  from  -1  to  1. 

for(i=0;i<100;i++) 

< transCbox"/  x,  y); 
x = x t .oi; 
y = y t .01; 

} 

VI.  OTHER  USER  INTERFACE  ROUTINES 

Additional  user  routines  are  available  and  are  described 
in  detail  in  the  Users  Manual  for  the  Vector  General  Display 
Unit  163.  Only  a brief  summary  of  each  routine  will  be 
presented  in  this  manual. 

1 . vqcl ock 

This  routine  allows  a user  to  set  the  refresh  rate 
of  the  vector  general  display.  The  vector  general  is  au- 
tomatically initialized  with  a refresh  rate  of  forty  hertz. 

2 . vqd i a 1 

The  routine  vgdial  returns  to  the  user's  program  the 
values  of  the  ten  variable  control  dials. 

3.  vggetcar 

The  routine  vgaetcar  will  return  to  the  user's  pro- 
gram a single  character  entered  at  the  vector  general  key- 
board. If  no  character  has  been  entered  a -1  will  be  re- 

turned. This  routine  does  not  display  the  characters  on  the 
vector  qeneral  display  screen. 
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U . voget f sw 

This  routine  will  return  to  a user's  program  the 


value  of  the  33  function  switches.  The  values  returned  will 
indicate  which  function  switches  are  depressed. 

5 . vo 1 amns 

This  routine  is  used  in  conjunction  with  vgoetf sw. 
It  will  turn  on  the  function  switch  lamp  for  each  function 
switch  that  is  depressed. 

6.  vapicture 

This  routine  causes  the  user's  picture  to  be 
displayed  on  the  vector  oeneral  display  screen.  Nothinq 
will  apoear  on  the  display  screen  until  this  routine  is 
called. 

7 . vqpost 

The  routine  vooost  allows  the  user  to  transform  the 
pictures  coordinate  axis.  This  transformation  will  cause 
the  entire  picture  to  be  repositioned  on  the  display  screen. 

8.  vapscal 

The  user  can  modify  the  scale  of  the  entire  picture 
by  calling  the  routine  vqoscal. 

9.  vQterw 

This  routine  terminates  the  vector  general  process 
and  releases  all  the  systems  resources  that  were  being  util- 
ized by  the  vector  general.  This  routine  should  be  called 
at  the  conclusion  of  all  vector  general  display  operations. 
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VII 


RUNNING  A VECTOR  GENERAL  PROGRAM 


A.  PROGRAM  FORMAT 

In  order  to  properly  utilize  the  vector  general  display 

system,  routines  to  initialize  and  terminate  the  system  must 

be  called.  These  routines  initialize  the  vector  general, 

start  the  actual  visual  display  and  properly  terminate  the 

display  at  the  end  of  a users  prooram.  Each  user  program 

must  include  a call  to  these  three  routines: 

sy s i n i t ( ) ; 
vgp  ictureOl 
vgt  erm ( ) ; 

The  first  routine,  svsinit,  must  be  called  by  the  user 
before  any  other  user  interface  routine  is  called.  To 
display  the  picture  that  a user  has  described  on  the  vector 
general  screen,  the  routine  vgoicture  must  be  called.  This 
routine  is  called  only  once,  and  nothina  will  appear  on  the 
screen  until  it  has  been  called.  Finally,  to  properly  ter- 
minate, the  system  requires  a call  to  the  routine  voterm  at 
the  end  of  t'he  user  program. 

8.  TO  COMPILE 

Once  a graphics  program  for  the  vector  general  has  been 
writted  in  the  C-languaoe  it  must  be  compiled  with  the  user 
interface  graphics  subroutine  library.  To  include  this  in- 
formation a user  should  issue  the  following  command  to 
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SAMPLE  PROGRAM 
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The  following  is  an  examde  of  a C-languaqe  vector  gen- 
eral qraphics  proaram.  The  actual  picture  produced  by  this 
program  is  illustrated  in  Figure  A-6. 


^include  "/usr/1 ib/vqcon.h" 

maint  ) 

< 

i nt  i » 

sysinitO*  //initailize  the  vector  general 


/ 


//define  coordinate  system 
coordsys(2»-l. 0,1. 0,-1. 0,1.0); 


d r awe  1 e C "bo x " ) ; 

set  vec  t o r ( V A , LN ) ; 

mo ve ( - 1 . 0 , - 1 . 0 ) ; 

1 i n e ( 1.0,  1.0); 

1 i n e ( 1.0,  1.0); 
line  (-1.0,  1.0); 

1 i n e ( - 1 . 0 , - 1 .0); 

ende 1 e ( ) ; 

cHare!e("name",  " % I BO  * M , SZ  4 , HOR , NSLNT  , VGREL  ) ,* 

draweleCziazaa"  ) ; 

set  vec  tor(VA,LM); 

mo ve ( -0 . 5 , -0 . 5 ) 
setvector(INCX,LN, .0308, NMG) ; 
move( .0308, .0308) ; 
f o r ( i =0  ; i<  7 ; i++  ) 

1 ine( .0308, .0308); 
ende 1 e ( ) ; 

//establish  ob j ec t -e 1 ement  relationship 
object(3,"bigb ox", "box", "name", "zigzag"), 
object(3,"smallbox", "box", "name", "zigzag"); 

scale("biqbox",0.B); 
t rans("biabox",-0.5,-0.5)  ; 
sca'eCsmal  lbox",0.25); 
trans("smal lbox",0.5,0.5); 

vqpictureO;  //display  picture 
sleeo(30);  //display  picture  for  30  sec 
vgtermC);  //terminate  vector  general  process 
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Picture  Displayed  bv  Sample  Proaram 
FIGURE  A -6 
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D.  ERROR  DIAGNOSTICS 


All  error  messages  will  be  printed  on  the  PDP-11  termi- 
nal screen  during  the  execution  of  a vector  general  graphics 
program.  The  error  message  will  identify  the  routine  that 
was  executina  when  the  error  occurred  and  the  error.  The 
errors  will  be  identified  by  a number.  A user  can  identify 
the  problem  by  referring  to  the  listinq  of  errors  in  this 
manual  or  by  referencing  the  specific  routine  in  Appendix  B, 
Most  errors  will  usually  result  in  the  termination  of  the 
routine  being  executed  with  control  being  returned  to  the 
user  proaram.  Every  effort  will  be  made  to  execute  the  pro- 
gram to  completion#  so  at  least  some  of  the  users  data  will 
be  displayed  on  the  vector  general  display  screen.  A 
description  of  each  possible  error  is  listed  in  Table-Ill. 
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T ABLE-  III 
ERROR  DIAGNOSTICS 


Routine  Error  Numbers! 


arc 

1 

i n t sc  a 1 e 

12 

blink 

2 

1 qh  t Den 

1 3 

charele 

3 

remove 

1 7 

circle 

a 

move 

15 

coordsys 

5 

object 

16 

c od  ve  1 e 

6 

remove 

1 7 

dr  awe  1 e 

7 

rotate 

18 

ende  1 e 

8 

scale 

19 

erase 

9 

setvector 

20 

indata 

1 0 

sy S i n i t 

21 

intoffset 

1 1 

t rans 

22 

Error  D i aqnost i C s : 

E01  Element  block  error.  The  soecified  routine 

has  been  called  outside  of  a drawele  block.  The 
instruction  will  be  ianored  ana  control  will  be 
returned  to  the  user's  oroqra*. 

E02  Soace  allocated  by  the  system  for  the  buildinq 

of  elements  has  been  exceeded.  See  the  routine 
remove  in  oroer  to  f ree  ud  unecessary  element 
memory  locations.  The  instruction  executing  when 
t * i s error  occurs  will  be  ianored  and  control  will 
be  returned  to  toe  user's  oroaram. 

E03  The  value  of  the  oarameter  dir  was  not  C or 

CC.  The  routine  will  be  ignored  and  no  arc  or 
circle  will  be  drawn  on  the  disolay. 

E09  A character  symbol  included  in  an  ASCII 

character  string  is  undefined.  The  symbol  will  be 
iqnored  and  control  will  be  returned  to  the  user's 
Droaram. 

EOS  The  named  object  does  not  exist#  it  has  not 

been  defined  in  a call  to  the  routine  object. 

EOb  The  named  element  does  not  exist#  it  has  not 

been  defined  in  a call  to  either  drawele  or 
c h a re  1 e . 


E07  An  element  name  has  been  duolicated  in  a 

drawele  or  charele  call.  Each  element  structure 
created  by  drawele  or  charele  must  have  a unique 
name . 
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E08  The  total  number  of  elements  allowed 

by  the  system  has  been  exceedmg. 

E09  The  number  of  objects  allowed  by  rhe 

system  has  been  exceeded. 

Ell  The  value  of  the  parameter  dim, 

soecifyinq  the  desired  number  of  d • «ions  for 
the  user  coordinate  system  is  not  a £ or  3. 

E19  The  specified  increment  value  falls  outside 

of  the  defined  coordinate  system,  the  value  will 
be  ianored  and  control  will  be  returneo  to  the 
user's  or oar am. 

E15  The  x coordinate  value,  or  the  x increment 

value  falls  outside  of  the  user's  defined  coordi- 
nate system.  The  instruction  executing  at  the 
time  of  the  error  will  be  ianored  and  the  move, 
line,  arc  or  circle  reauested  will  not  be  drawn  on 
the  display  screen. 

E16  The  y coordinate  value,  or  the  v increment 

value  falls  outside  of  the  user's  defined  coordi- 
nate system.  The  instruction  executing  at  the 

time  of  the  error  will  be  ignored  and  the  move, 
line,  arc  or  c i rc 1 e reauested  will  not  be  drawn  on 
the  display  screen. 

E17  The  z coordinate  valum,  or  the  z increment 

value  falls  outside  of  the  user's  defined  coordi- 
nate system.  The  instruction  executing  at  the 

time  of  the  error  will  be  ianored  and  the  move, 
line,  arc  or  circle  reauested  will  not  be  drawn  on 
the  display  screen. 

E18  The  value  of  the  parameter  num, 

specifying  the  number  of  elements  beinq  passed  in 
this  routine  is  not  between  1 and  10. 

E19  A circle  or  arc  cannot  be  drawn  by  an 

incremental  vector. 

E20  The  I enoth  of  the  user  buffer  specified 

for  the  routine  indata  is  too  small.  The  amount 
of  data  input  fro"  the  keyboard  exceeded  the 
ouffer  size,  characters  received  after  the  buffer 
boundry  will  be  ignored. 
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A named  element  within  a parameter  list 
is  not  associated  with  the  specified  oDject.  The 
element  was  not  linked  to  the  named  object  in  a 
call  to  the  routine  object.  The  routine  executinq 
at  the  time  of  this  will  stop  and  return  control 
to  the  user's  oroqram. 
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APPENDIX  B:  USER  INTERFACE  ROUTINE  DESCRIPTIONS 

The  description  of  the  user  interface  routines  appear 
in  the  same  format  as  the  routine  descriptions  in  the  UNIX 
Reference  Manual  at  the  Naval  Postgraduate  School  Computer 
L abo  r a t ory. 
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arc  arc 

NAME : 


arc  - draw  an  arc 


SYNOPSIS: 

arc (di ricent*  (icentyl  ( , c en t z ) , ena x f,endyl  f,endzl); 

dir:  CC  / 004  - counter  clockwise 
C / 010  - clockwise 

float  cent*  [»centyl  f , cen t z 1 , endx  [,endyl  Iiendtl  } 


DESCRIPTION: 

An  arc  is  drawn  f row  the  present  beam  location,  about 
the  designated  center  ooint,  to  the  user  specified  end 
ooint.  If  the  center  point  is  not  an  ersual  distance 
from  the  startina  point  of  the  arc  and  the  end  point, 
an  arc  will  be  drawn  us i no  one  of  the  distances  as  the 
radius.  The  result,  is  a straioht  line  drawn  from  the 
actual  termination  point  of  the  arc  to  the  user  speci- 
fied end  point. 

The  parameters  passed  for  the  center  point  and  end 
point  of  the  arc  are  either  relative  or  absolute 
values.  The  number  and  value  of  these  parameters  are 
determined  by  the  vector  type  selected  in  the  previous 
call  to  setvjctor. 

Arcs  cannot  be  drawn  by  any  of  the  four  incremental 
vectors. 

The  z parameters  are  reauired  only  when  the  coordinate 
system  is  defined  as  three  dimensional,  and  will  be 
ignored  if  included  when  2 dimensional  is  specified. 


DIAGNOSTICS: 

All  error  messaoes  will  be  printed  on  the  PDP-11  ter- 
minal sc  reen . 

Error  - E01  - This  routine  has  been  called  outside 
of  a draw  element  block. 

Error  - E02  - The  space  allocated  for  the  buildina 
of  elements  has  been  exceeded. 

Error  - E03  - The  draw  direction  was  not  defined 
as  either  C or  CC. 

Error  - E15  - The  x value  was  out  of  bounds. 


feP 


arc 


arc 


Error 
E r r o r 
E r r o r 


The  y value  was  out  of  bounds. 
The  z value  was  out  of  bounds. 
Illegal  arc/circle  instruction 
from  an  incremental  vector. 


ALSO  SEE: 


setvector  - qives  parameter  requirements  for  each 
vector  tyre. 
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NAME 


blink 


blink  the  entire  picture  or  the  specified 
object  or  elements 


SYNOPSIS: 


action: 

ON  / 01  - blink 

OFF  / 00  - stop  blinking  action 

Parameter  values: 

PIC  / 00 
OBJ  / -1 


To  blink  tne  entire  picture: 
bl ink( action, PIC); 


To  blink  a specific  object: 

bl  ink(action,08J,"objname"); 


To  blink  elements  of  a specific  object: 

bl  inkfact i on, num, "obj name ",Melel",ele2 "»...)» 
i n t num ; 


DESCRIPTION: 

The  blink  mode  for  the  entire  picture,  a single  ob- 
ject or  any  number  of  elements  of  a specific  object, 
can  be  turned  on  or  off. 

Modifying  the  blink  mode  of  an  object  affects  all  ele- 
ments linked  to  that  object. 

num  specifies  the  number  of  element  names  being  passed 
in  this  routine,  num  can  vary  between  1 ana  10. 


DIAGNOSTICS: 


All  errors  will  be  printed  on  the 


POP- 1 1 terminal 


r 


blink 


screen. 

Error  - E05  - Unknown  object  name. 

Error  - EOfe  - Unknown  element  name. 

Error  - E18  - Value  num  not  between  1-10. 


blink 
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chare)  e 


c h a re  1 e 


NAME : 


charele  - displays  an  ASCII  character  string 
on  the  Vector  General 


SYNOPSIS: 

charele("el ename"»charpt  r , s i ze  * wd i r , si  ant , xpos,ypos) » 

float  xpos,  yoos; 

size: 


sz 

/ 

00  - use 

ore  v 

‘ous  character 

size 

SZ1 

/ 

h 1 0 0 - set 

s ’ ze 

h O 

100 

col.  by 

60 

1 i res 

SZ2 

/ 

0 120  - set 

size 

t O 

81 

col . by 

<41 

lines 

SZ3 

/ 

0 1 At 0 - set 

size 

t 0 

60 

col . by 

30 

lines 

SZ<i 

/ 

016  0 • set 

size 

t o 

32 

col.  by 

1 6 

lines 

wd  i r : 

HOR  / 00  - write  characters  horizontally 

VEP  / 020  0 - write  characters  vertically 

s’  ant  : 

SLNT  / 00  - slant  characters 

NSLNT  / 01  - do  not  slant  characters 

xpos : 

VGREL-  to  output  characters  relative  to  the 

present  beam  position  the  parameter  xnos 
should  be  replaced  with  VGREL  and 
parameter  ypos  should  be  omitted. 


DESCRIPTION: 

This  routine  displays  the  ASCII  character  string, 
specified  by  charotr*  on  the  vector  general  screen. 
The  characters  can  be  output  by  specifying  the  desired 
coordinate  starting  point  (xpos»ynos)  or  by  outputing 
the  string  relative  to  the  present  beam  location.  The 
symbols  available  include  formatting  symbols  and  an 
extended  character  set.  These  can  be  included  in  any 
character  string  by  including  the  proper  identifying 
symbols.  The  character  string  formatting  symbols  are: 
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c h a re  1 e 


Chare) e 


KEYBOARD 

SYMBOL 


FORMAT 


X<5  backspace»moves  back  one  character  space 

XA  line  feed#  position  center  screen 

XB  linefeed 

XC  position  at  top#center  of  screen 

XO  position  at  top# left  corner  of  screen 

XE  carriage  control#  line  feed 

XF  ignored 

XG  ignored 

XH  special  character 

XI  neq.  line  feed#moves  up  one  line 

XJ  decreases  current  character  size  by  one 

XK  increases  current  character  size  by  one 

Due  to  the  extended  character  set  available  on  the 
vector  qeneral#  all  special  character  symbols  are  pre- 
ceded by  a percent  sign.  In  order  to  have  a percent 
sign  appear  on  the  screen#  two  percent  signs  (XX)  must 
appear  in  the  character  string.  A list  of  the  special 
characters  available  are  listed  on  the  next  page  under 
Extended  Character  Set. 


DIAGNOSTICS: 


All  errors  will  be  printed 
screen. 


PDP-11  terminal 


Error  - 


Error  - 


Error  - 


The  space  allocated  for  the  building 
of  elements  has  been  exceeaed. 
Incorrect  ASCII  character  symbol 
found  in  character  string. 

Maximum  number  of  elements 
per  picture  exceeded. 


c h a r e I e 


charele 


Extended  Character  Set 


KEYBOARD  CHARACTER 

SYMBOL 


Xspace 

X! 

Xm 

Xn 

x% 

XH 

XI 


X' 


X( 
X ) 


□ 


* 


J 

V 


Z3 


X* 
X ♦ 
X. 

X- 

X. 

x/ 

xo 

XI 


X2 


X3 

XU 

xs 


10 

, • 


t 

V 

□ 

A 
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c ha  re  1 e 


chare  I e 


A 


X ' 


2a 

OC 

Xh 

(3 

Xc 

S7 

Xd 

S 

Xe 

£ 

Xf 

5* 

Xa 

2T 

Xh 

X 

Xi 

L 

Xj 

\ 

X k 

/ 

XI 

X 

Xm 

> 

Xn 

V 

Xo 

Xd 

TT 

2a 

6 

Xr 

p 

Xs 

<r 

Xt 

Xu 

Xv 

o 

Xw 

y 

Xx 

i 

• 

Xv 
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f 


c h a r e 1 e 


chap^lp 


Xz 
X< 
X\ 
X > 
X-> 
X? 


r 


H 
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circle 


circle 


NAME : 

circle  - draw  a circle 
SYNOPSIS: 

c i rc 1 e ( d i r , c en t x (#centy)  [>centzl  ) 

dir:  CC  / 00<4  - counter  clockwise 
C / 010  - clockwise 

float  centx  (*centyl  [#centzl  » 


DESCRIPTION: 

A circle  is  drawn  f ro"  the  oresent  beam  location  about 
the  indicated  center  ooint.  / 

The  parameters  passed  for  the  center  point  of  the  cir- 
cle are  either  relative  or  absolute  values.  The 
number  and  value  of  these  parameters  are  determined  by 
the  vector  type  selected  in  the  previous  call  to  set- 
vector. 

Circles  cannot  be  drawn  by  any  of  the  four  incremental 
vectors. 


DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 


m i na 1 sc  reen 

i • 

E r r o r 

m 

E01 

- 

This  routine  has  been  called  outside 
of  a draw  element  block. 

E r ro  r 

E02 

m 

The  space  allocated  for  the  buildina 
of  elements  has  been  exceeded. 

Error 

«• 

E0  5 

• 

The  draw  direction  was  not  defined 
as  either  C or  CC . 

Error 

- 

E 1 5 

- 

The  x value  was  out  of  bounds. 

Error 

- 

Elb 

- 

The  y value  was  out  of  bounds. 

Error 

- 

E 1 7 

- 

The  z value  was  out  of  bounds. 

Error 

E 1 9 

m 

Illegal  arc/circle  instruction 
from  an  incremental  vector. 

ALSO  SEE: 

setvector 

- 

gives 

vector 

parameter  reaui rements  for  each 
type . 
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coordsys 


coords  vs 


1 


NAME : 

coordsys  - define  user  coordinate  system 


SYNOPSIS: 

C 00 r ds y s ( d i m , m i n x , ma x x , m i n y , ma x y ( , m i nz  , ma  x z ) ); 

i n t dim; 

float  m i n x , m a x x , m i n y , i»a  x y [,minz,maxzl 


DESCRIPTION: 

Defines  a two  or  three  dimensional  cartesian  coordi- 
nate system,  of  any  scale,  for  the  user.  The  parameter 
dim  specifies  the  number  of  dimensions  reauired.  If 


d i m 
spec  i 

i s 

f i ed 

2 

• 

t * e 

n only 

the 

range 

of  x and  y need  to  be 

minx 

must 

be 

s t 

r i c t 1 y 

less 

than 

m a x x . 

mi  ny 

must 

ce 

s t 

r i c t 1 y 

less 

than 

ma  x y • 

pin; 

mus  t 

be 

s t 

r i c t 1 v 

less 

than 

max  2 . 

All  subseauent  user  coordinate  values  are  interpreted 
according  to  this  user  defined  coordinate  system. 

If  coordsys  is  not  called  by  the  user  the  default 
values  will  pe  taken.  The  default  coordinate  system  is 
three  dimensional  with  x,  y,  z ranging  from  -100.0  to 
100.0.  All  coordinate  values  received  will  be  inter- 
preted according  to  these  default  values  unless  the 
coordinate  system  is  redefined  by  the  user. 


DIAGNOSTICS: 

Any  values  which  fall  outside  of  the  defined  coordi- 
nate system  will  be  ignored  and  an  error  message 
specifying  which  coordinate  values  were  out  of  range 
will  be  printed  on  the  PDP-11  terminal  screen. 
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copye  1 e 
NA^E : 


copyele 


cooye  1 e 


specify  additional  names  to  be  used 
in  referencing  a specific  element  block 


SYNOPSIS: 

cooyel e(num, "el ename" * "namel " * "name?" * . . . ) ! 
i n t num ; 


DESCRIPTION: 

This  routine  allows  the  user  to  qive  several  uniaue 
names  to  a specific  element  block.  In  this  manner*  a 
user  can  link  one  element  to  an  object  several  times 
and  can  uniquely  reference  each  occurrence  of  the 
element  within  the  object. 

num  specifies  the  number  of  element  names  oeinq  passed 
in  this  routine*  num  can  vary  between  l and  10. 

DIAGNOSTICS: 

All  error  messaaes  will  be  printed  on  the  PDP-11  ter- 
minal screen. 

Error  - E06  - Unknown  element  name. 

Error  - E07  - Duplicate  element  name. 

Error  - E 1 6 - Value  num  not  between  1-10. 


ALSO  SEE: 

drawe  1 e * object 


d r awe  1 e 


drawel e 


NAME  : 

drawel e - start  a draw  element  block 


SYNOPSIS: 

drawele("elename") * 


DESCRIPTION: 

This  routine  specifies  the  beqinninq  of  a draw  element 
block.  It  associates  a unique  name  with  the  group  of 
draw  instructions  that  fall  in  between  this  call  and  a 
call  to  endele.  The  resulting  picture  segment  will 
then  be  referenced  by  the  name  specified/  as  the  ele- 
ment name»  in  this  routine. 

A user  mav  want  to  reoeat  a specific  element  block 
structure  several  times  within  one  object.  Instead  of 
specifying  several  element  blocks  which  describe  the 
same  structure  a user  can  indicate  a group  of  names 
which  refer  to  one  specific  element  block.  These 
unique  names  each  referring  to  the  same  structure  can 
then  be  linked  to  an  object/  and  each  can  be  uniquely 
referenced.  This  association  of  several  names  with  one 
element  can  be  accomplished  by  the  routine  copyele. 


DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal screen. 

Error  - E01  - This  routine  has  been  called  outside 
of  a draw  element  block. 

Error  - E 0 2 - The  space  allocated  for  the  building 
of  elements  has  been  exceeded. 

Error  - E07  - Duplicate  element  name. 


ALSO  SEE: 

copyele/  object 
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ende  1 e 


ende  1 e 


1 


NAME : 


ende 1 e 


end  of  the  current  element  block 


SYNOPSIS: 

ende 1 e O » 


DESCRIPTION: 

Specifies  the  termination  of  a list  of  draw  instruc- 
tions describing  a specific  element.  The  picture  seg- 
ment described  by  this  group  of  draw  instructions# 
that  fall  between  a drawele  and  endele  call#  will  be 
referenced  by  name  specified  in  the  drawele. 

A new  element  block  cannot  begin  until  the  previous 
block  has  been  properly  terminated  by  a call  to 
endele. 


DIAGNOSTICS: 

This  routine  must  be  called  to  properly  end  a draw 
element  block.  If  a block  is  not  prooerl v terminated 
prior  to  the  beginning  of  a new  element  block,  all 
drawele  calls  will  be  ianored  and  any  draw  instruc- 
tions that  follow  will  be  associated  with  the  element 
block  that  has  not  been  terminated. 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal sc  reen . 

Error  - E 0 1 - This  routine  has  been  called  outside 
of  a draw  element  block. 

Error  - E02  - The  space  allocated  for  the  buildina 
of  elements  has  been  exceeded. 
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erase 


NAME  : 


erase  - erase  the  specified  portions  of  the  picture 


SYNOPSIS: 

Paramet er  values: 

PIC  / 00 
OBJ  / -1 

To  erase  the  entire  picture: 
erase (P  IC  ) ; 

To  erase  a specific  object: 

erase(08J#"objname")» 

To  erase  elements  of  a specific  object: 

erase(num,"objnameM#"elel"#"ele2"#..); 
i n t num ; 

DESCRIPTION: 

The  entire  picture#  specified  object  or  the  listed 
elements  of  a specific  object#  will  be  erased  from  the 
vector  general  display  screen.  The  elements  still 
exist.  To  redisplay  any  portion  of  the  erased  picture# 
the  appropriate  e 1 emen t -ob j ec t linking  must  again  be 
done  by  the  user. 

num  specifies  the  number  of  element  names  being  passed 
in  this  rout i ne  . 

DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal sc  reen . 

Error  - EOS  - Unknown  object  name. 

Error  - EOb  - Unknown  element  name. 

Error  - E18  - Value  num  not  between  1-10. 

Error  - E2l  - Element  not  associated  with 
the  named  object, 

ALSO  SEE: 

remove 


errormsg 


e r r o r msq 


NAME  : 

errormsq  - print  error  messages  on  PDP-11  terminal 
screen 

SYNOPSIS: 

errormsg(action); 

action: 

ON  / 01  - print  errors  on  PDP-11  terminal 
OFF  / 00  - stop  printinq  of  error  messaqes 

DESCRIPTION: 

All  error  messaaes  will  automatically  be  printed  on 
the  PDP-11  terminal  screen.  The  user  can  control  the 
printinq  of  error  messaaes  durinq  any  portion  of  a 
program  by  calling  this  routine. 


85 


indata 


inaata 


r 


NAME : 

indata  - input  data  from  the  vector  general 
keyboard 


SYNOPSIS: 

indataCbuffer, length, xpos,yoos) ? 
char  *bu  fieri 
i nt  lenath; 
float  xoos , vpos  J 


DESCRIPTION: 

This  routine  allows  the  user  to  enter  data  from  the 
vector  general  keyboard  onto  the  vector  aeneral 
display  screen  beginning  at  the  position  indicated  bv 
xpos,  yoos.  The  data,  ASCII  character  codes,  will 
also  be  placed  in  the  user  buffer  specified  by  buffer. 
The  length  of  the  user  buffer  must  be  soecifed  by  the 
parameter  length.  A cursor  will  be  displayed  at  the 
initial  position  and  all  data  will  remain  on  the 
display  screen  until  a carriage  return  is  entered  by 
the  user.  All  data  olacea  in  the  user's  buffer  will 
remain  unaltered. 

A listing  of  the  ASCII  character  code  for  every  key- 
board entry  is  listed  on  the  next  page. 


DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal sc  reen . 

Error  - E15  - The  x value  was  out  of  bounds. 

Error  - Elfe  - The  y value  was  out  of  bounds. 

Error  - E20  - User  buffer  dimensioned  to  small. 


i ndat  a 


indata 


OCTAL 

CHARACTFR 

GENERATED 

KEYBOARD 

CODE 

SYMBOL 

symbol 

000 

NULL 

( i anored) 

5 Ctrl 

001 

SO  erase  last  char. 

A Ctrl 

002 

ST  X 

( i anored) 

R Ctrl 

003 

ETX 

C i qno  red ) 

C Ctrl 

OOU 

EOT 

( i anored) 

D Ctrl 

005 

ENO 

(ianored) 

E Ctrl 

00b 

ACK 

( i anored) 

F Ctrl 

007 

REL 

( i anored) 

G Ctrl 

010 

PS 

RS 

01  1 

HT 

(LF,  cent ) 

I Ctrl 

012 

LF 

LF 

013 

VT 

(top,  cent ) 

K Ctrl 

oia 

FF 

(top,  left) 

L Ctrl 

015 

NL 

(CR,  LF) 

CR 

016 

SE 

( i anored) 

N Ctrl 

017 

SI 

( i anored) 

O Ctrl 

020 

DLE 

(clear  aueue) 

p Ctrl 

021 

DC  1 

(-LF) 

O Ctrl 

022 

DC2 

(-SZ) 

R Ctrl 

023 

DC  3 

(tSZ) 

S Ctrl 

02a 

oca 

(terminate) 

T Ctrl 

025 

NAK 

( i anored) 

U Ctrl 

02b 

SYN 

( i anored) 

V Ctrl 

027 

FTP 

( ianored) 

W Ctrl 

030 

CAN 

( i anored ) 

X Ctrl 

031 

EM 

( i anored ) 

Y Ctrl 

032 

SUP 

( i qno  red ) 

7 Ctrl 

033 

ESC 

(escape ) 

t Ctrl 

03a 

FS 

( i anored ) 

\ Ctrl 

035 

GS 

( i anored) 

1 Ctrl 

03b 

RS 

( i gno  red ) 

^ Ctrl 

037 

US 

( i ano  r ed ) 

OaO 

Space 

sp  bar 

oa  l 

i 

1 shift 

0a2 

n 

2 shift 

0a3 

n 

3 shift 

oaa 

n 

a shift 

oa5 

X 

5 shift 

oab 

& 

b shift 

oa7 

i 

7 shift 

050 

( 

8 Shift 

051 

) 

R shift 

052 

* 

: shift 

053 

♦ 

J shift 

05a 

, 

t 

055 

- 

- 

05  b 

• 

• 

057 

/ 

/ 

ObO 

0 

0 
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i ndat  a 


indata 


061 

1 

1 

062 

2 

2 

063 

3 

3 

06a 

a 

a 

065 

5 

5 

066 

6 

6 

067 

7 

7 

070 

8 

8 

071 

Q 

Q 

072 

• 

• 

• 

• 

073 

• 

9 

• 

0 

074 

< 

9 shift 

075 

~ 

- shift 

076 

> 

. Shift 

077 

1 

100 

a 

101 

A 

A shift 

102 

8 

B shift 

103 

c 

C shift 

l oa 

0 

0 shift 

105 

E 

E shift 

106 

E 

E shift 

107 

G 

G shift 

1 10 

H 

H shift 

1 1 1 

T 

I shift 

112 

J 

J Shift 

1 1 3 

K 

K shift 

1 1 a 

L 

L Shift 

115 

u 

v shift 

116 

N 

N shift 

1 1 7 

0 

0 shift 

120 

p 

P shift 

121 

0 

Q shift 

122 

P 

P shift 

123 

s 

8 shift 

12a 

T 

T shift 

125 

U 

U shift 

126 

V 

V shift 

127 

w 

W shift 

130 

X 

X shift 

131 

Y 

Y shift 

132 

7 

Z Shift 

133 

C 

[ 

13a 

\ 

\ 

135 

1 

1 

136 

A 

/N 

137 

«-(sub#suoerscriDt  ) 

iao 

% 

H shift 

l a i 

a 

A 

l a2 

h 

R 

1 a3 

c 

C 

1 aa 

d 

0 

«8 


indata 


i ndat  a 


145 

e 

E 

146 

f 

F 

147 

d 

G 

150 

h 

H 

151 

i 

I 

152 

] 

J 

153 

k 

K 

154 

1 

L 

155 

m 

M 

156 

n 

N 

157 

o 

0 

160 

D 

p 

161 

a 

Q 

162 

p 

9 

163 

s 

S 

164 

t 

T 

165 

u 

U 

166 

V 

V 

167 

w 

W 

170 

X 

X 

171 

V 

Y 

172 

7 

7 

173 

( 

1 shift 

174 

1 

t 

\ shift 

175 

> 

( shift 

176 

/\  shift 

177 

del 

DEL 

200 

a 

space  spec 

201 

t 

1 shift 

soec 

202 

II 

2 shift 

soec 

203 

o 

3 shift 

spec 

204 

£ 

0 shift 

soec 

205 

V 

5 shift 

soec 

206 

f 

6 shift 

soec 

207 

4 

7 shift 

spec 

250 

c. 

8 shift 

soec 

251 

=» 

9 shift 

spec 

252 

10 

( subsc  r i pt ) 

: shift 

spec 

253 

• 

• 

» shift 

spec 

254 

, spec 

255 

s 

- spec 

256 

. spec 

257 

— 1 

/ spec 

260 

o 

0 spec 

261 

t 

1 spec 

262 

V 

2 spec 

263 

□ 

3 spec 

264 

£ 

0 spec 

265 

A 

(centered) 

5 spec 

266 

9 

6 spec 

267 

Z. 

7 soec 

270 

u 

8 spec 
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i nda t a i nda  t a 


271 

n V 

9 spec 

272 

• 

(centered) 

: spec 

273 

X 

; spec 

279 

<— ~ 

, shift  spec 

315 

[TO 

M shift  spec 

31b 

TV. 

N 1 shift  spec 

317 

ft 

0 shift  spec 

320 

ir 

P shift  spec 

321 

O 

Q shift  spec 

322 

* 

R shift  spec 

323 

z 

S shift  spec 

329 

e 

T shift  spec 

325 

i 

U shift  spec 

326 

5 

V shift  spec 

327 

A 

W shift  spec 

330 

r 

X shift  spec 

331 

r~ 

Y shift  spec 

332 

_____ 

2 shift  spec 

333 

L 

( shift  soec 

339 

spec 

335 

h 

1 shift  spec 

336 

* 

f'  spec 

337 

o 4 

spec 

390 

> 1 

(b 1 inking) 

5 shift  spec 

391 

eC 

a shift  spec 

392 

B shift  spec 

393 

V 

C shift  spec 

399 

s 

0 shift  spec 

395 

£ 

E shift  spec 

396 

* 

P shift  spec 

397 

* 

f)  shift  spec 

350 

H shift  spec 

351 

6 

I shift  spec 

352 

\ 

J shift  spec 

353 

^ * 

K shift  spec 

359 

L shift  soec 

355 

JLt 

w shift  spec 

35b 

V 

N shift  spec 

357 

u) 

0 shift  spec 

360 

■w 

P shift  spec 

3ftl 

B 

Q Shift  spec 

362 

p 

9 shift  soec 

363 

<y 

S shift  soec 

369 

f 

T shift  spec 

365 

) 

U shift  spec 

366 

o 

V shift  spec 

367 

J 

W shift  spec 

370 

; 

X shift  spec 

371 

21 

Y shift  spec 

372 

Z shift  spec 

373 

5J 

( spec  shift 

379 

r 

spec  shift 
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J spec  shift 
* spec  shift 
DEL  spec 


intoff  set 


intoffset 


NAME: 


intoffset  - object  intensity  offset 


SYNOPSIS: 

intoffset ("objname",val  ) f 
float  val  J 


DESCRIPTION: 

The  intensity  ranqe  of  the  specified  object  is  deter- 
mined by  the  parameter  val.  If  val  is  oner  the  max- 
imum intensity  ranqe  is  achieved.  If  the  value  is 
zero*  the  intensity  is  constant  and  the  image  has  no 
dept  h -c  ue i nq . 


DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal sc  reen  . 

Error  - E05  - Unknown  object  name. 


ALSO  SEE: 


i nt  sea  1 e 


i n t sc  a 1 e 


i n t sc  a 1 e 


NAME : 


intscale  - modify  object  intensity  scale 


SYNOPSIS: 

intscale("objname"*val  )» 
float  va 1 # 


DESCRIPTION: 

The  intensity  range  of  an  object*  which  qives  a three 
dimensional  object  its  depth  cueing*  is  determined  by 
the  parameter  val.  The  range  of  val  is  from  zero  to 
one.  If  val  is  one  the  maximum  intensity  range  is 
obtained*  if  it  is  zero  the  object  has  no  depth  cue- 
i ng . 


DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal sc  reen . 

Error  - E05  - Unknown  object  name. 


ALSO  SEE: 

intoffset 


P3 


1 gh  t pen 


1 gh  t pen 


NAME: 


1 gh  t pen 

- set 
the 

lightoen  hookability  of 
p i c t u r e , ob j ec t or  elements 

SYNOPSIS: 

action: 

ON  / 
OFF  / 

01  - Set  light  pen  hookability 
00  - Clear  light  pen  hookability 

Paramet e r values: 


PIC  / 00 
OBJ  / -1 

To  set  hookability  of  the  entire  picture: 

IghtoenCact ion, PIC)  ; 

To  set  hookability  of  an  object: 

IghtoenCact i on, OBJ, "objname")  ! 

To  set  hookability  of  elements  of  a specific  object: 
lghtpenCact ion,mjm, "objname" , "el  el " , "el e2", . . . ) » 
i n t num ; 

DESCRIPTION: 

The  user  can  specify  which  picture  segments  will  be 
light  pen  bookable.  These  elements  designated  as  light 
pen  bookable  will  be  effected  by  light  pen  interaction 
xwith  the  vector  general  display  screen. 

num  specifies  the  number  of  element  names  being  passed 
in  this  routine,  num  can  vary  between  1 and  10. 

DIAGNOSTICS: 

All  errors  will  be  printed  on  the  POP-11  terminal 
screen . 

Error  - EOS  - Unknown  object  name. 


pa 


1 qh  t pen 


1 gh  t pen 


E r ro  r 
Error 
E r ro  r 


EOto  - Unknown  element  name. 
E18  - Value  num  not  between  1 
E21  - Element  not  associated 
the  named  object. 
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line 


1 i ne 


NAME  : 

line  - draw  a line 
SYNOPSIS: 

1 ine(oar»  [,paryl  (,parz)  ); 
float  parx  [,oary]  [,oarzl  » 


DESCRIPTION: 

A line  is  drawn  to  the  location  specified  by  the  x , y , z 
coordinate  values.  The  values  may  specify  actual  abso- 
lute coordinate  points  or  an  incremental  value  which 
will  be  added  to  or  subtracted  from  the  previous  x»y,z 
coordinate  point.  The  number  of  Parameters  and  their 
values  are  determined  by  the  vector  type  specified  in 
the  preceding  call  to  setvector. 


DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal screen. 

Error  - E01 

Error  - E02 

Error  - E 1 5 
Error  - E16 
Error  - E 1 7 


ALSO  SEE: 

setvector  - gives  parameter  requirements  for  each 
vector  type. 


R6 


- This  routine  has  been  called  outside 
of  a draw  element  block. 

- The  soace  allocated  for  the  puilding 

of  elements  has  been  exceeded. 

- The  * value  was  out  of  bounds. 

- The  y value  was  out  of  bounds. 

- The  z value  was  out  of  bounds. 


■ ■ wtm 


move  move 

NAME  : 


move 


move  to  the  specified 


location 


SYNOPSIS: 

movetnar*  [,pary]  (,oarz)  ); 
float  oarx  [,paryl  [»oarzl  ; 


DESCRIPTION: 

The  beam  is  moved  to  the  location  specified  bv  the 
x,y,z  coordinate  values.  The  values  may  specify  actual 
absolute  coordinate  points  or  an  incremental  value 
which  will  be  added  to  or  subtracted  form  the  previous 
x*y»z  coordinate  values.  The  number  of  parameters  and 
their  values  are  determined  by  the  vector  type  speci- 
fied in  the  preceding  call  to  setvector. 


DIAGNOSTIC: 


All  error  messages  will 
m i na 1 sc  reen . 


be  orinted  on  the  PDP-11  ter- 


Error  - E01  - This  routine  has  been  called  outside 
of  a draw  element  block. 

Error  - E02  - The  space  allocated  for  the  buildina 


O f 

elements 

has 

been 

exceeded 

Error  - E15  - The 

X 

value 

was 

out 

o f 

bounds 

Error  - E 1 6 - The 

y 

value 

was 

out 

o f 

bounds 

Error  - E17  - The 

z 

value 

was 

out 

of 

bounds 

ALSO  SEE: 

setvector 


gives  parameter  reguirements  for  each 
vector  type. 
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object 


object 


NAME  : 

object  - link  elements  to  specified  object  name 
SYNOPSIS: 

object(num,"objname"»"elel"»"ele2"*....); 
i n t num ; 


DESCRIPTION: 

Associates  with  the  named  object  each  of  the  listed 
elements.  This  picture  segment*  or  element  grouping 
will  be  referenced  by  the  object  name  specified  in 
this  routine. 

Every  element  must  be  linked  to  at  least  one  object 
inorder  for  it  to  be  displayed  on  the  vector  general 
screen.  A user  can  link  one  or  more  element  names  to 
an  object.  Elements  can  be  linked  to  an  object  by  one 
or  several  calls  to  this  routine.  An  element  can  be 
linked  to  several  different  objects*  or  one  element 
may  be  linked  several  times  to  the  same  object. 

If  an  object  or  element  has  been  erased  from  the 
display  screen,  a user  can  redisolav  the  desired  ob- 
ject or  elements  by  again  establishing  the  desired 
ob j ec t -e 1 emen t association. 

num  specifies  the  number  of  element  names  being  passed 
in  this  routine*  num  can  vary  between  1 and  10. 

DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal screen. 

Error  - E05  - Unknown  object  name. 

Error  - EOb  - Unknown  element  name. 

Error  - EOS  - Number  of  elements  allowed 
per  picture  exceeded. 

Error  - E09  - Maximum  number  of  objects 

allowed  per  picture  (101  exceeded. 

ALSO  SEE: 

drawe 1 e * copye  1 e 
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remove 


NAME  : 

remove  - erase  the  indicated  portion  of  the  picture 
and  remove  the  associated  elements  from 
memory 

SYNOPSIS: 

Parameter  v a 1 ues  : 

PIC  / Oh 

To  remove  the  entire  picture: 
remove (PIC); 

To  remove  element  structures  : 

remove(num,"elel"»"ele2"f 
i n t num ; 

DESCRIPTION: 

The  entire  picture?  or  every  occurrence  of  the  named 
elements  are  erased  from  the  vector  general  display 
screen.  Eacn  name  element  structure  will  be  removed 
f row  memo  r y . 

To  redisplay  any  portion  of  the  removed  picture  re- 
quires that  the  user  rebuild  each  element  ana  relink 
it  to  the  appropriate  objects. 

num  specifies  the  number  of  element  names  being  passed 
in  this  routine. 

DIAGNOSTICS: 

All  error  messaaes  will  be  printed  on  the  PDP-11  ter- 
minal screen. 

Error  - £05  - Unknown  object  name. 

Error  - E06  - Unknown  element  name. 

Error  - E18  - Value  num  not  between  1-10. 

Error  - E21  - Element  not  associated  with 
the  named  ob  j ec  t . 

ALSO  SEE: 

erase 
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rotate  rotate 

name  : 


rotate  - rotate  an  object 


SYNOPSIS: 

rot  a t e ( "ob  j name"  > x r ad  i arts  , y radi  ans  l.zradiansl  )} 
float  x radi ans » y radi ans  Utradiansl  ! 


DESCRIPTION: 

The  named  object  will  be  rotated  about  the  t,  y,  2 
coordinate  axis.  The  parameters,  qiven  in  radian  meas* 
ure.  specify  the  degree  of  rotation  desired  about  each 
axis. 

The  2 parameter  is  reauired  only  when  the  coordinate 
system  is  defined  as  three  dimensional  and  will  be 
ignored  otherwise. 


DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal screen. 

Error  - E05  - Unknown  object  name. 
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scale 


scale 


NAME : 

scale  - modify  object  scale 


SYNOPSIS: 

sc  a 1 e ( " ob j name  " * scale); 
f 1 oat  scale; 


DESCRIPTION: 

All  elements  associated  with  the  named  object  are 
scaled  by  the  value  scale  at  display  time.  The  range 
of  scale  is  from  zero  to  one.  If  not  established  by  a 
user  this  value  automatically  aefaults  to  one*  which 
is  the  maximum  picture  scale. 


DIAGNOSTICS: 

All  error  messaaes  will  be  printed  on  the  PDP-11  ter- 
minal screen. 

Error  - EOS  - Unknown  object  name. 
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set  vec  t or 


set  vec  tor 


NAME : 


setvector  - specify  the  vector  tyoe  and  vector  mode 


SYNOPSIS: 


set vec t or ( v t voe # vnode  t # i nc 1 l » sc  a 1 e)  ); 


v t voe : 


VR 
VRX 
VR  Y 
VRZ 
VA 
VAX 
VA  Y 
VAZ 
INC? 
I NC  X 
INCY 
I NC  3 


vector 

relative 

vector 

relative 

auto 

vector 

relative 

auto 

vector 

r e 1 a t i ve 

auto 

vector 

absol ut  e 

vector 

absolute 

auto 

vector 

absolute 

auto 

vector 

absolute 

auto 

vector  incremental 
vector  incremental 
vector  incremental 
vector  incremental 


-increment  * 

- i nc  r emen  t y 
-increment  z 

- i nc  r emen  t x 
-increment  v 
-increment  z 

2- di mens i ona 1 
auto-increment 
auto-i nc  rement 

3- dimensional 


x 


V 


vmode : 

LN 

/ 

00 

DSH 

/ 

020 

DOT 

/ 

oao 

PN  T 

/ 

060 

DD 

/0  1 20 

ODD 

/0  1 uo 

line 

dashed  line 
dotted  line 
end  oo i n t 

dash-dot -dash  line 
dash-dot -dash  line 


scale: 

MG  / 000  - add  the  coordinate  increments 
to  the  high  order  bits  of  the 
specified  register. 

Nmg  /0200  - add  the  coordinate  increments 
to  the  low  order  bits  of  the 
specified  register. 


float  i nc » 


DESCRIPTION: 

This  routine  specifies  which  one  of  the  12  vector 
types  is  to  be  drawn  in  the  line#  move#  circle  and  arc 
instructions  which  follow.  It  also  specifies  the  vec- 
tor mode  (i.e.»  liner  dotted#  dashed#  etc.)#  and  if 
required#  the  increment  value  for  auto-increment  vec- 
tors and  the  scale  factor  for  incremental  vectors. 
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set  vec t or 


setvector 


The  coordinate  values  passed  in  the  followinq  draw 
instructions  are  dependent  on  the  vector  tyoe  selected 
in  this  routine. 

This  must  follow  a drawele  call  and  preced  any  draw 
instructions.  This  routine  can  be  called  any  number  of 
times  within  a draw  element  block. 

The  bracketed  z parameters  are  required  only  when  the 
coordinate  system  has  been  defined  as  three  dimension* 
a 1 . 


DIAGNOSTICS: 


All  error  messaqes  will  be  printed  on  the  PDP-11  ter- 
minal screen. 


E r r o r 

• 

E01 

E r r o r 

- 

E02 

E r ro  r 

- 

E 1 3 

Error 

- 

E 1 5 

E r r o r 

- 

E 1 6 

Error 

- 

El  7 

E r r o r 

- 

E19 

This  routine  has  been  called  outside 
of  a draw  element  block. 

The  soace  allocated  for  the  buildinq 
of  elements  has  been  exceeded. 

Vector  tyoe  undefined. 

The  x value  was  out  of  bounds. 

The  y value  was  out  of  bounds. 

The  z value  was  out  o*  bounds. 

Illeqal  arc/circle  instruction 
from  an  incremental  vector. 
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setvector  - VA 


set  vec  tor 


VA 


name  : 


VA  - vector  absolute 
SYNOPSIS: 

draweleCelename"), 


setvector(VA,vmode)» 

move (coord* , coordy  f,coordzl  ); 

1 i ne ( coord x , coordy  I>coordzl  )» 

c i rc 1 e ( d i r , cen t x , cen t y I»centz)  ); 

arc ( d i r , cent x , cent y ( , c en t z 1 * end x , endy  (»endzl); 


ende 1 e ( ) # 

float  coordx , coordy  l,coordzl  ; 

float  centx,centy  l , cen t z 1 , endx , endy  [,endzl; 


DESCRIPTION: 

The  x,y,z  coordinates  of  absolute  vectors  are  speci- 
fied with  resoect  to  the  origin,  or  zero  position  of 
the  user  defined  coordinate  system.  Each  x,  y,  z coor- 
dinate value  references  a unique  point  on  the  display 
screen. 


DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal screen. 

Error  - E01  - This  routine  has  been  called  outside 
of  a draw  element  block. 

Error  - E02  - The  space  allocated  for  the  building 


of 

e 1 ement  s 

has 

been 

exceeded . 

Error  - E13  - Vector 

t ype 

unde  f i ned. 

Error  - E15  - The 

X 

value 

was 

out 

of 

bounds . 

Error  - E 1 b - The 

V 

value 

was 

out 

o f 

bounds . 

Error  - E17  - The 

z 

value 

was 

out 

of 

bounds . 

set  vec  t or 


VAX 


setvector  -VAX 


NAME  : 


VAX  - vector  absolute  au t o- i nc r emen t * 
SYNOPSIS: 


drawele("elenameHl  ; 


setvector{VAX,v'node»*inc)» 
moveCcoordy  l»coord:l  ); 
movefcoordy  l/coordzl  )! 
c i rc l e ( d i r , c en t y I/centzJ  )? 
arc(dir»centy  t > c en t z 1 , endy  I/endzJ); 


ende 1 e ( ) ; 

! 

float  nine,  coordy  t/coordzl  } 
float  certy  (» cent z)  > endy  I/endzJ/ 

DESCRIPTION: 

The  vector  absolute  auto-increment  x causes  the  ini- 
tial x coordinate  value  to  fe  incremented  or  decre- 
mented by  the  value  specified  by  xinc.  With  every 
move/  line*  arc»  or  circle  command  the  specified  y and 
z coordinate  values  are  updated  while  the  x coordinate 
value  is  stepped  by  the  constant  value  xinc.  For 

example/  the  pointCx/  yz  z)  becomes  point (x+xinc/ 
coordy/  coordz  ) . 

The  value  of  xinc  cannot  exceed  the  ranqe  of  the  de- 
fined coordinate  system. 


DIAGNOSTICS: 


All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal sc  reen . 


Error  - E 0 1 

Er ror  - E02 

E r ro  r - E 1 3 
Error  - E 1 4 

E r ro  r - E 1 b 
Error  - E 1 7 


This  routine  has  been  called  outside 
of  a draw  element  block. 

The  space  allocated  for  the  building 
of  elements  has  been  exceeded. 

Vector  type  undefined. 


The  increment  value 
bounds . 

The  y value  was  out 
The  z value  was  out 


was  out  of 

of  bounds, 
of  bounds. 
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setvector  - V A Y 


setvector 


VA  Y 


NAME  : 


VAY  - vector  absolute  au t o- i nc remen t y 
SYNOPSIS: 

drawele(Helename"); 


setvectorfVAY, ymodei yinc  ) J 
moveCcoord*  I.coordzi  )J 
1 inetcoord*  (.coordz)  )? 
c i rc 1 e ( di r , cent x I.centz)  ); 
arc(dir,centx  I , cent zl  » endx  (»endz)  ) ; 


ende 1 e ( ) » 

float  yinc»coordx  Ucoordzl  ; 
float  centx  l > cent z)  , endx  [, endz)  ; 


DESCRIPTION: 

The  vector  absolute  au t o- i nc r emen t y causes  the  ini- 
tial y coordinate  value  to  be  incremented  or  decre- 
mented by  the  value  spec i f i ed  by  yinc.  to  i t h every 
move*  line.  arc  or  circle  command  the  specified  x and 
z coordinate  values  are  updated  while  the  y coordinate 
value  is  stepped  by  the  constant  value  yinc.  For 
example,  the  ooint(x.y.z)  becomes  po i n t ( coo r dx , y + y i nc  . 
coordz) . 

The  value  of  yinc  cannot  exceed  the  range  of  the  de- 
fined coordinate  system. 


DIAGNOSTICS: 

. All  error  messaoes  will  be  printed  on  the  PDP-11  ter* 
m i na 1 sc  reen . 

Error  - E01  - This  routine  has  been  called  outside 
of  a draw  element  block. 

Error  - E02  - The  space  allocated  for  the  building 
of  elements  has  been  exceeded. 

Error  - E13  - Vector  type  undefined. 

Error  - E1R  - The  increment  value  was  out  of 
bounds . 

Error  - E15  - The  x value  was  out  of  bounds. 

Error  - €17  - The  z value  was  out  of  bounds. 


set  vec tor 


setvector  - VAZ 


- VAZ 


NAME  : 

VAZ  - vector  absolute  auto-increment  z 


SYNOPSIS: 

drawe)e("elename"); 


setvector(VAZ#vmode>zinc); 
move(coordx  > c oo  rdy ) } 

1 ine(coordv,coordy); 

circle(dir,cent*fCenty); 

arc (di r , c en  t x .cent  y.endx.endy)  ; 


ende 1 e ( ) ; 

float  z i nc » C oo r dx . coo rdy i 
float  cent x , cent y * endx . endy ; 


DESCRIPTION: 


The  vector  absolute 
tial  2 coordinate 
rented  by  the  value 
mo  ve » line,  arc  or 
y coordinate  values 
value  is  s teooed 
e x amp le  the  pointfx 
♦ 2 i nc  ) . 


aut o- i nc rerent  2 causes  the  ini- 
value  to  be  incremented  or  decre- 
specified  by  2inc.  With  every 
circle  command  the  specified  x and 
are  updated  while  the  2 coordinate 
by  the  constant  value  2 i nc . For 
y »z)  becomes  point (coordnicoordy. z 


The  value  of  zinc  cannot  exceed  the  ranae  of  the  de- 
fined coordinate  system. 


DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal sc  reen . 


Error  - E01 

Error  - E0<? 

Error  - E 1 3 
Error  - E 1 4 

Error  - E 1 5 
Error  - E 1 b 


This  routine  has  been  called  outside 
of  a draw  element  block. 

The  space  allocated  for  the  building 
of  elements  has  been  exceeded. 

Vector  type  undefined. 

The  increment  value  was  out  of 
bounds  . 

The  x value  was  out  of  bounds. 

The  y value  was  out  of  bounds. 
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set  vec  tor  - VR 


setvector 


VR 


1 

NAME;  VR  - vector  relative 
SYNOPSIS: 

drawele("elename"l/ 


setvector(VR,vmode)  : 

mo ve ( de 1 t a x , de 1 t ay  l»deltazl  ); 

1 i ne (de 1 t a x , de 1 t ay  I/deltazl  )! 
circle(dir,eentx,centy»  Icent  zl  ); 
arc(dir,centx.centy(,centz) »endx,endyl,endz) ) ; 


ende 1 e ( ) ; 

float  de 1 t ax , de 1 t ay  l.deltazl  » 
float  centx,centy  ( » cent z]  , endx , endy  [»endzl  » 

1 

DESCRIPTION: 

Relative  vectors  specify  a increment  value  that  is  to 
be  added  to  or  subtracted  from  the  initial  x,y,z  abso- 
lute coordinate  values.  For  examolp,  the  point (xfy,z) 
becomes  do i nt ( x + de 1 t ax , y ♦ de 1 t ay t z tde 1 t a z ) . 

The  parameter  values  cannot  exceed  the  ranqe  of  the 
defined  coordinate  system. 


DIAGNOSTICS: 


A 1 1 
mi  nal 

Error 

E r ro  r 

E r ro  r 
E r r o r 
E r ro  r 
E r ro  r 


E01  - This  routine  has  been  called  outside 
of  a draw  element  block. 

E02  - The  soace  allocated  for  the  building 
of  elements  has  been  exceeded. 

E13  - Vector  type  undefined. 


E 1 5 - The 

X 

value 

was 

out 

o f 

bounds 

E16  - The 

V 

value 

was 

out 

of 

bounds 

E 1 7 - The 

z 

value 

was 

out 

o f 

bounds 

error  messaqes  will  be  printed  on  the  PDP-11  ter- 
se reen . 


1 OB 


set  vec  t or 


VRX 


set  vec  t or 


VRX 


NAME : 


VRX 


vector  relative  auto-i  nc  reireot  * 


SYNOPSIS: 

drawele("elename"); 


isetvector(VRX,vmode*xinc) 

move(de1tay  Udeltazl  )! 

Iine(de1tay  (*de1taz)  ); 

circletdir.centv  f , c e n t z J ) ; 

arc (di r * cent v t > cent  zl  , endy  liendzl  ) <’ 


ende  !#?()? 

float  xinc/deltay  t»del tazl  ! 
float  centy  [ » c en t z 1 , endy  liendzl  » 


DESCRIPTION: 

A vector  relative  auto-increment  x causes  the  initial 
x coordinate  value  to  be  incremented  or  decremented  by 
the  constant  value  xinc.  With  every  move*  line*  arc 
or  circle  instruction  that  follows*  the  y and  z coor- 
dinate values  will-  be  uodateai  while  x is  stepped  by 
the  value  xinc.  For  example*  the  point(x*y,z)  becomes 
point(xtxinc*y*deltay*z+de1taz). 

The  parameter  values  cannot  exceed  the  range  of  the 
defined  coordinate  system. 


DIAGNOSTICS: 


All  error  messaqes  will  be  printed  on  the  PDP-11 
mi na 1 sc  reen  . 


ter- 


Error  - E01  - This  routine  has  been  called  outside 
of  a draw  element  block. 

Error  - E02  - The  space  allocated  for  the  buildina 
of  elements  has  been  exceeded. 

Error  - E13  - Vector  type  undefined. 

Error  - E19  - The  increment  value  was  out  of 
bounds . 

Error  - E16  - The  y value  was  out  of  bounds. 

Error  - E17  - The  z value  was  out  of  bounds. 


1 09 


I 


set  vector 


VRY 


set  vec  t or 


VRY 


i 


NAME : 

VRY  - vector  relative  aut o-i nc rement  y 
SYNOPSIS: 

drawele("elename"); 


setvector(VRY,vmode,yinc) 

move(deltax  (rdeltazl  ); 

lineCdeltax  (, delta?]  ); 

c i rc 1 e ( d i r , c en t * [»centtl  ); 

arc (di r, cent x ( .cent z) » end*  l.endz]); 


ende 1 e C ) ; 

float  yinc»del ta*  t.deltaz)  ; 
float  cent*  l » cent zl > end*  Uendz)  ; 


DESCRIPTION: 

A vector  relative  auto-increment  y causes  the  initial 
y coordinate  value  to  be  incremented  or  decremented  by 
the  constant  value  vine.  With  every  move#  liner  arc 
or  circle  instruction  that  follows.  the  * and  z coor- 
dinate values  will  be  uDdatedi  while  y is  stepoed  by 
the  value  yinc.  For  e*ample»  the  point (*ry»z)  becomes 
point (xtdel ta»(ytyinc«ztdel taz) . 

The  parameter  values  cannot  exceed  the  ranqe  of  the 
defined  coordinate  system. 


DIAGNOSTICS: 

All  error  messaaes  will  be  Drinted  on  the  PDP-11  ter- 
rn  i na  1 sc  reen . 

Error  - E01  - This  routine  has  been  called  outside 
of  a draw  element  block. 

Error  - E02  - The  soace  allocated  for  the  buildina 
of  elements  has  been  exceeded. 

Error  - E13  - Vector  type  undefined. 

Error  - E14  - The  increment  value  was  out  of 
bounds . 

Error  - E15  - The  x value  was  out  of  bounds. 

Error  - E 1 7 - The  z value  was  out  of  bounds. 


1 1 0 


setvector  - VRZ 


setvector 


VRZ 


NAME: 


VRZ  - vector  relative  auto-increment  z 
SYNOPSIS: 

draweleCelename"); 


setvectorCVRZ/vmode/zinc) 
wo ve ( de 1 t a x / deltay)? 

1 inetdelta*  /deltay)/ 

ci rcl e(di r,cent«,centv)  ; 

arc (di r»cent x/centy/endx/endy) » 


ende 1 e C ) ; 

float  z i nc , de 1 t a x , de 1 t a v ! 
float  cent x * cent y » end* f endy J 


DESCRIPTION: 

A vector  relative  aut o-i nc rement  z causes  the  initial 
z coordinate  value  to  be  incremented  or  decremented  by 
the  constant  value  zinc.  With  every  mover  line/  arc 
or  circle  instruction  that  follows/  the  x and  y coor- 
dinate values  will  he  undated/  while  z is  steered  by 
the  value  zinc.  For  examclef  the  point(«/yfz)  becomes 
ooint (xtdel ta*r ytdel t ay#  zti nez)  . 

The  parameter  values  cannot  exceed  the  range  of  the 
defined  coordinate  system. 


DIAGNOSTICS: 


All  error  messaaes  will  be  printed  on  the  PDP-11  ter- 


This  routine  has  been  called  outside 
of  a draw  element  block. 

The  space  allocated  for  the  buildina 
of  elements  has  been  exceeded. 

Vector  type  undefined. 

The  increment  value  was  out  of 
bounds • 

The  x value  was  out  of  bounds. 

The  y value  was  out  of  bounds. 


mi nal  sc  reer 

1 • 

E r r o r 

- 

E01 

Error 

• 

E0^ 

Error 

m 

El  3 

Error 

- 

E l a 

Error 

•B 

E 1 5 

Error 

- 

Elb 

set  vec  t or 


INC? 


se  t vec  t o r 


INC? 


Name  : 

INC?  - incremental  vector  , two  dimensional 


SYNOPSIS: 

drawele("elename")* 


setvector(lNC?»vmode»scale); 
mo ve (de 1 t a x , de 1 tay)  » 

1 ine(delta»»de)tay); 


ende 1 e ( ) ; 

float  delta*, delt ay; 
scale: 

MG  - add  the  coordinate  increments  to  the  7 

hiqh  order  bits  of  the  soecified  reqister. 
NMG-  add  the  coordinate  increments  to  the  7 

low  order  bits  of  the  specified  reqister. 


DESCRIPTION: 

A two  dimensional  relative  vector,  that  halves  vector 
storaqe  requirements  and  doubles  the  data  rate.  This 
vector  tyoe  should  be  used  when  element  storaqe  space 
is  critical.  This  reduced  storage  requirement  results 
from  a limitation  on  the  maximum  size  of  each  relative 
increment.  The  values  passed  in  line  or  move  instruc- 
tions are  limited  to  aoorox i ma t e 1 y 3*  of  the  user 
minimum  and  maximum  coordinate  ranges.  The  parameter, 
scale,  specifies  if  this  increment  value  should  be 
added  to  the  7 hiqh  order  bits  of  the  specified  coor- 
dinate or  to  the  7 low  order  bits.  This  scale  factor 
then  determines  if  the  increments  will  be  applied  over 
a fine(NMG)  or  coarseCMG)  grid. 

Arcs  and  circles  cannot  be  drawn  with  this  vector 
type . 


DIAGNOSTICS: 

All  error  messaqes  will  be  printed  on  the  PDP-11  ter- 
minal sc  reen . 

Error  - E01  - This  routine  has  been  called  outside 


11? 


set  vec  tor 


INC? 


set  vec  t or 


INC? 


E r ro  r 

E r ro  r 
E r r o r 
E r r o r 
Error 


of  a draw  element  block. 

EO?  - The  space  allocated  for  the  building 
of  elements  has  been  exceeded. 

E13  - Vector  type  undefined. 

E15  - The  x value  was  out  of  bounds. 

E!6  - The  y value  was  out  of  bounds. 

E19  - Illegal  arc/circle  instruction 
from  an  incremental  vector. 


setvector 


INC* 


setvector  - INCX 


NAME  : 

INCX  - incremental  vector  ,two  dimensional 
auto-inc remen  t x 


SYNOPSIS: 

drawelef"elename"); 


setvectorfINCX,vmode»xinc, scale); 

move(deltay»^eltay); 

Hne(deltavfCieltay); 


ende 1 e ( ) » 

float  x i nc  » de 1 1 ay ; 
scale: 

MG  - add  the  coordinate  increments  to  the  7 

hiqh  order  bits  of  the  soec i f i ed  register. 
NMG-  add  the  coordinate  increments  to  the  7 

low  order  bits  of  the  specified  register. 

DESCRIPTION: 

A two  dimensional  relative  vector#  that  halves  vector 
storaoe  requirements  and  doubles  the  data  rate.  This 
vector  type  should  be  used  when  element  storage  space 
is  critical.  This  reduced  storaqe  requirement  results 
from  a limitation  on  the  maximum  si?e  of  each  relative 
increment.  The  values  passed  in  line  or  move  instruc- 
tions are  limited  to  approximately  3%  of  the  user 
minimum  and  maximum  coordinate  ranqes.  The  parameter, 
scale,  specifies  if  this  increment  value  should  be 
added  to  the  7 high  order  bits  of  the  specified  coor- 
dinate or  to  the  7 low  order  bits.  This  scale  factor 

then  determines  if  the  increments  will  be  applied  over 
a fine(NMG)  or  coarse(MG)  qrid. 

This  incremental,  auto  increment  vector  causes  the  x 
coordinate  value  to  be  incremented  or  decremented  by 
the  constant  value  xinc*  while  the  y coordinate  value 
is  increment  by  small  relative  values. 

Arcs  and  circles  cannot  be  drawn  with  this  vector 
type. 


1 1 a 


■ 


setvector  - IMCX 


setvector  - INCX 


DIAGNOSTICS: 


ATI  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal screen. 


Error  - E 0 1 

Error  - E 02 

Error  - El  3 
E r ro  r - E 1 <4 

Error  - E16 
Error  - E 1 9 


This  routine  has  been  called  outside 
of  a draw  element  block. 

The  soace  allocated  for  the  building 
of  elements  has  been  exceeded. 

Vector  tyoe  undefined. 

The  increment  value  was  out  of 
bounds . 

The  y value  was  out  of  bounds. 
Illegal  arc/circle  instruction 
from  an  incremental  vector. 
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set  vector 


INCY 


set  vec  tor 


INCY 


NAME : 

INCY  - incremental  vector  ,two  dimensional 
auto-increment  y 


SYNOPSIS: 

drawele("elenameH)J 


setvector(INCY,vmode,yinc,scale); 

move(deltax,deltax); 

1 ine(deltax,deltax); 


ende 1 e ( ) ; 

float  y i nc  * de 1 t ax ; 
scale: 

MG  - add  the  coordinate  increments  to  the  7 

high  order  bits  of  the  specified  register. 
NMG-  add  the  coordinate  increments  to  the  7 

low  order  bits  of  the  specified  register. 


DESCRIPTION: 

A two  dimensional  relative  vector,  that  halves  vector 
storage  requirements  and  doubles  the  data  rate.  This 
vector  type  should  be  used  when  element  storaqe  space 
is  critical.  This  reduced  storage  requirement  results 
from  a limitation  on  the  maximum  size  of  each  relative 
increment.  The  values  passed  in  line  or  move  instruc- 
tions are  limited  to  approximately  33  of  the  user 
minimum  and  maximum  coordinate  ranges.  The  parameter, 
scale,  specifies  if  this  increment  value  should  be 
added  to  the  7 hiqh  order  bits  of  the  specified  coor- 
dinate or  to  the  7 low  order  bits.  This  scale  factor 
then  determines  if  the  increments  will  be  applied  over 
a fine(NMG)  or  coarse(MG)  grid. 

This  incremental,  auto  increment  vector  causes  the  v 
coordinate  value  to  be  incremented  or  decremented  by 
the  constant  value  xinc,  while  the  y coordinate  value 
is  increment  by  small  relative  values. 

Arcs  and  circles  cannot  be  drawn  with  this  vector 
t yoe  • 
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set  vec  tor 


INCY 


set  vector 


INCY 


DIAGNOSTICS: 

All  error  messages  will  be  printed  on  the  PDP-11  ter- 
minal screen. 

Error  - E01  - This  routine  has  been  called  outside 
of  a draw  element  block. 

Error  - E02  - The  space  allocated  for  the  building 
of  elements  has  been  exceeded. 

Error  - E13  - Vector  type  undefined. 

Error  - E1U  - The  increment  value  was  out  of 
bounds  . 

Error  - E15  - The  x value  was  out  of  bounds. 

Error  - E19  - Illegal  arc/circle  instruction 
from  an  incremental  vector. 
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set  vector 


I NC  3 


set  vec  t or 


I NC  3 


NAME  : 


INC3  - incremental  vector  /three  dimensional 


SYNOPSIS: 

drawele("elename"); 


setvector(INCX/vmode/Scale); 
move (de 1 tax/del tay/del tat)  } 

1 ineCdel t ax / de 1 t ay  » de 1 tat)  ! 


ende 1 e ( ) / 

float  de 1 t ax / de 1 t ay / de 1 t a? / 
scale: 

MR  - add  the  coordinate  increments  to  the  7 

high  order  bits  of  the  SDecified  reqister. 
NMG-  add  the  coordinate  increments  to  the  7 

low  order  bits  of  the  specified  register. 


DESCRIPTION: 

A three  dimensional  relative  vector/  that  halves  vec- 
tor storage  requirements  and  doubles  the  data  rate. 
This  vector  type  should  be  used  when  element  storage 
space  is  critical.  This  reduced  storage  reauirement 
results  from  a limitation  on  the  maximum  size  of  each 
relative  increment.  The  values  passed  in  line  or  move 
instructions  are  limited  to  approx i mat  el y 3%  of  the 
user  minimum  and  maximum  coordinate  ranges.  The 
paramater/  scale/  specifies  if  this  increment  value 
should  be  added  to  the  7 hiqh  order  bits  of  the  speci- 
fied coordinate  or  to  the  7 low  order  bits.  This 
scale  factor  then  determines  if  the  increments  will  be 
applied  over  a fine(NMG)  or  coarse(MG)  grid. 

Arcs  and  circles  cannot  be  drawn  with  this  vector 
t yoe . 


DIAGNOSTICS: 

All  error  messaaes  will  be  orinted  on  the  PDP-11  ter- 
minal sc  reen . 


lift 


se  t vec  t o r 


INC3 


setvector  - INC3 


Error  - E01 

Error  - E 05 

E r ro r - E 1 3 
Error  - E 1 5 
E r ro  r - E 1 6 
Error  - E17 
E r ro  r - E 1 9 


This  routine  has  been  called  outside 
o*  a draw  element  block. 

The  SDace  allocated  for  the  building 
of  elements  has  been  exceeded. 

Vector  type  undefined. 

The  x value  was  out  of  bounds. 

The  v value  was  out  of  bounds. 

The  z value  was  out  of  bounds. 

Illegal  arc/circle  instruction 
from  an  incremental  vector. 
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sysinit  sysinit 


NAME : 

sysinit  - vector  general  display  initialization 

SYNOPSIS: 

sy  s i n i t ( ) # 


DESCRIPTION: 

This  routine  establishes  a link  with  the  vector  gen- 
eral/ initializes  its  display  system  and  sets  all  the 
user  default  carameters. 

This  routine  must  be  called  before  any  other  display 
i ns  t rue  t i on  s . 


DIAGNOSTICS: 

If  the  initialization  cannot  be  properly  completed/  an 
error  message  will  be  printed  on  the  PDP-11  terminal 
and  the  process  will  be  terminated.  This  error  could 
occur  because  the  vector  qeneral  is  being  accessed  bv 
a another  user. 
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t Pans 


t r ans 


NAME  : 

trans  - translate  object 


SYNOPSIS: 

t rans ( "ob j name" * x » y (>z)  )! 

float  x , y ( i z 1 ; 


DESCRIPTION: 

All  of  the  elements  associated  with  the  named  object 
are  translated  by  the  amount  x,  y,  z at  disolay  time. 
Each  coordinate  point (X,Y,Z)  of  the  object  becomes 
po i nt ( X + x t Y + y , Z + z ) at  d splay  time. 

The  z parameter  is  reouired  only  when  the  coordinate 
system  is  defined  as  three  dimensional ( and  will  De 
ignored  if  included. 


DIAGNOSTICS: 

All  error  messaaes  will  be  printed  on  the  PDP-11  ter- 
minal screen. 

Error  - EOS  - Unknown  object  name. 
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